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Section 3 


Database design and 
implementation 


In large programming shops, database administrators are usually responsible for 
designing the databases that are used by production applications, and they may 
also be responsible for the databases that are used for testing those applications. 
Often, though, programmers are asked to design, create, or maintain small 
databases that are used for testing. Апа in a small shop, programmers may also 
be responsible for the production databases. 

So whether you're a database administrator or a SQL programmer, you need 
the skills and knowledge presented in this section. That's true even if you aren't 
ever called upon to design or maintain a database. By understanding what's 
going on behind the scenes, you'll be able to use SQL more effectively. 

So in chapter 9, you'll learn how to design a database. In chapter 10, you'll 
learn how to use the Data Definition Language (DDL) statements to create and 
maintain the tables, indexes, and sequences of a database. In chapter 11, you'll 
learn how to create and maintain views, which are database objects that provide 
another way to look at tables. Finally, in chapter 12, you'll learn how to design 
the security for your database by creating users that have restricted access to 
your database. 


9 


How to design a database 


In this chapter, you'll learn how to design a new database. This is useful 
information whether or not you ever design a database on your own. To 
illustrate this process, I'll use the accounts payable (AP) database that you've 
seen throughout this book. 
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How to design a data structure 


Databases are often designed by database administrators (DBAs) or design 
specialists. This is especially true for large, multiuser databases. How well this 
is done can directly affect your job as a SQL programmer. In general, a well 
designed database is easy to understand and query, while a poorly designed 
database is difficult to work with. In fact, when you work with a poorly de- 
signed database, you will often need to figure out how it is designed before you 
can code your queries appropriately. 

The topics that follow will teach you a basic approach for designing a data 
structure. We use that term to refer to a model of the database rather than the 
database itself. Once you design the data structure, you can use the techniques 
presented in the next two chapters to create a database with that design. By 
understanding the right way to design a database, you'll work more effectively 
as a SOL programmer. 


The basic steps for designing a data structure 


In many cases, you can design a data structure based on an existing real- 
world system. The illustration at the top of figure 9-1 presents a conceptual 
view of how this works. Here, you can see that all of the information about the 
people, documents, and facilities within a real-world system is mapped to the 
tables, columns, and rows of a database system. 

As you design a data structure, each table represents one object, or entity, in 
the real-world system. Then, within each table, each column stores one item of 
information, or attribute, for the entity, and each row stores one occurrence, or 
instance, of the entity. 

This figure also presents the six steps you can follow to design a data 
structure. You'll learn more about each of these steps in the topics that follow. In 
general, though, step 1 is to identify all the data elements that need to be stored 
in the database. Step 2 is to break complex elements down into smaller compo- 
nents whenever that makes sense. Step 3 is to identify the tables that will make 
up the system and to determine which data elements are assigned as columns in 
each table. Step 4 is to define the relationships between the tables by identifying 
the primary and foreign keys. Step 5 is to normalize the database to reduce data 
redundancy. And step 6 is to identify the indexes that are needed for each table. 

To model a database system after a real-world system, you can use a 
technique called entity-relationship (ER) modeling. Because this is a complex 
subject of its own, I won't present it in this book. However, I have applied some 
of the basic elements of this technique to the design diagrams presented in this 
chapter. In effect, then, you'll be learning some of the basics of this modeling 
technique. 
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А database system is modeled after a real-world system 


Real-world system Database system 


Facilities 


Other 
Systems 


The six basic steps for designing a data structure 


Step 1: Identify the data elements 

Step 2: Subdivide each element into its smallest useful components 
Step 3: Identify the tables and assign columns 

Step 4: Identify the primary and foreign keys 

Step 5: Review whether the data structure is normalized 

Step 6: Identify the indexes 


Description 


А relational database system should model the real-world environment where it's used. 
The job of the designer is to analyze the real-world system and then map it onto a 
relational database system. 


A table in a relational database typically represents an object, or entity, in the real world. 
Each column of a table is used to store an attribute associated with the entity, and each 
row represents one instance of the entity. 

To model a database and the relationships between its tables after a real-world system, 


you can use a technique called entity-relationship (ER) modeling. Some of the diagrams 
you'll see in this chapter apply the basic elements of ER modeling. 


Figure 9-1 The basic steps for designing a data structure 
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How to identify the data elements 


The first step for designing a data structure is to identify the data elements 
required by the system. You can use several techniques to do that, including 
analyzing the existing system if there is one, evaluating comparable systems, 
and interviewing anyone who will be using the system. One particularly good 
source of information are the documents used by an existing system. 

In figure 9-2, for example, you can see an invoice that's used by an accounts 
payable system. We'll use this document as the main source of information for 
the database design presented in this chapter. Keep in mind, though, that you'll 
want to use all available resources when you design your own database. 

If you study this document, you'll notice that it contains information about 
three different entities: vendors, invoices, and line items. First, the form itself 
has preprinted information about the vendor who issued the invoice, such as the 
vendor's name and address. If this vendor were to issue another invoice, this 
information wouldn't change. 

This document also contains specific information about the invoice. Some 
of this information, such as the invoice number, invoice date, and invoice total, 
is general in nature. Although the actual information will vary from one invoice 
to the next, each invoice will include this information. In addition to this general 
information, each invoice includes information about the items that were 
purchased. Although each line item contains similar information, each invoice 
can contain a different number of line items. 

One of the things you need to consider as you review a document like this is 
how much information your system needs to track. For an accounts payable 
system, for example, you may not need to store detailed data such as the infor- 
mation about each line item. Instead, you may just need to store summary data 
like the invoice total. As you think about what data elements to include in the 
database, then, you should have an idea of what information you'll need to get 
back out of the system. 
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An invoice that can be used to identify data elements 


Custom Contraptions, Contrivances and Confabulations 
1234 West Industrial Way EastLos Angeles California 90022 | |Invoice Date: 10/05/08 
800.555.1212 fax 562.555.1213 www.acmefabrication.com| | Terms: Net 30 


Description Unit Price Extension 


CUST345 Design service, hr 

457332 Baling wire, 25x3ft roll 
50173 Duct tape, black, yd 
328771 Rubber tubing, 100ft roll 


CUST281 Assembly, hr 
CUST917 Testing, hr 


Sales Tax 


Your salesperson: Ruben Goldberg, ext 4512 Р LX 
i 2 PLEASE PAY THIS AMOUNT 
Accounts receivable: Inigo Jones, ext 4901 


Thanks for your business! 


The data elements identified on the invoice document 


Vendor name Invoice date Item extension 
Vendor address Invoice terms Vendor sales contact name 
Vendor phone number Item part number Vendor sales contact extension 
Vendor fax number Item quantity Vendor AR contact name 
Vendor web address Item description Vendor AR contact extension 
Invoice number Item unit price Invoice total 

Description 


e Depending on the nature of the system, you can identify data elements in a variety of 
ways, including interviewing users, analyzing existing systems, and evaluating compa- 
rable systems. 

e The documents used by a real-world system, such as the invoice shown above, can often 
help you identify the data elements of the system. 


e As you identify the data elements of a system, you should begin thinking about the 
entities that those elements are associated with. That will help you identify the tables of 
the database later on. 


Figure 9-2 How to identify the data elements 
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How to subdivide the data elements 


Some of the data elements you identify in step 1 of the design procedure 
will consist of multiple components. The next step, then, is to divide these 
elements into their smallest useful values. Figure 9-3 shows how you can do 
that. 

The first example in this figure shows how you can divide the name of the 
sales contact for a vendor. Here, the name is divided into two elements: a first 
name and a last name. When you divide a name like this, you can easily perform 
operations like sorting by last name and using the first name in a salutation, 
such as “Dear Ruben.” In contrast, if the full name is stored in a single column, 
you have to use the string functions to extract the component you need. But as 
you learned in the last chapter, that can lead to inefficient and complicated code. 
In general, then, you should separate a name like this whenever you'll need to 
use the name components separately. Later, when you need to use the full name, 
you can combine the first and last names using concatenation. 

The second example shows how you typically divide an address. Notice in 
this example that the street number and street name are stored in a single 
column. Although you could store these components in separate columns, that 
usually doesn't make sense since these values are typically used together. That's 
what I mean when I say the data elements should be divided into their smallest 
useful values. 

With that guideline in mind, you might even need to divide a single string 
into two or more components. А bulk mail system, for example, might require a 
separate column for the first three digits of the zip code. And a telephone 
number could require as many as four columns: one for the area code, one for 
the three-digit prefix, one for the four-digit number, and one for the extension. 

As in the previous step, knowledge of the real-world system and of the 
information that will be extracted from the database is critical. In some circum- 
stances, it may be okay to store data elements with multiple components in a 
single column. That can simplify your design and reduce the overall number of 
columns. In general, though, most designers divide data elements as much as 
possible. That way, it's easy to accommodate almost any query, and you don't 
have to change the database design later on when you realize that you need to 
use just part of a column value. 
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А name that's divided into first and last names 


Vendor sales contact name 


Ruben Goldberg 


Vendor sales contact first name 


An address that's divided into street address, city, state, and zip code 


Vendor sales contact last name 


Goldberg 


Vendor address 


1234 West Industrial Way, East Los Angeles, California 90022 


1234 West Industrial Way East Los Angeles California 


Description 


e Ifadata element contains two or more components, you should consider subdividing the 


element into those components. That way, you won't need to parse the element each time 
you use it. 


e The extent to which you subdivide a data element depends on how it will be used. 
Because it's difficult to predict all future uses for the data, most designers subdivide data 
elements as much as possible. 


e When you subdivide a data element, you can easily rebuild it when necessary by concat- 
enating the individual components. 


Figure 9-3 How to subdivide the data elements 
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How to identify the tables and assign columns 


Figure 9-4 presents the three main entities for the accounts payable system 
and lists the possible data elements that can be associated with each one. In 
most cases, you'll recognize the main entities that need to be included in a data 
structure as you identify the data elements. As I reviewed the data elements 
represented on the invoice document in figure 9-2, for example, I identified the 
three entities shown in this figure: vendors, invoices, and invoice line items. 
Although you may identify additional entities later on in the design process, it's 
sufficient to identity the main entities at this point. These entities will become 
the tables of the database. 

After you identify the main entities, you need to determine which data 
elements are associated with each entity. These elements will become the 
columns of the tables. In many cases, the associations are obvious. For example, 
it's easy to determine that the vendor name and address are associated with the 
vendors entity and the invoice date and invoice total are associated with the 
invoices entity. Some associations, however, aren't so obvious. In that case, you 
may need to list a data element under two or more entities. In this figure, for 
example, you can see that the invoice number is included in both the invoices 
and invoice line items entities and the account number is included in all three 
entities. Later, when you normalize the data structure, you may be able to 
remove these repeated elements. For now, though, it's okay to include them. 

Before I go on, I want to point out the notation I used in this figure. To start, 
any data elements I included that weren't identified in previous steps are shown 
in italics. Although you should be able to identify most of the data elements in 
the first two steps of the design process, you'll occasionally think of additional 
elements during the third step. In this case, since the initial list of data elements 
was based on a single document, I added several data elements to this list. 

Similarly, you may decide during this step that you don't need some of the 
data elements you've identified. For example, I decided that I didn't need the 
fax number or web address of each vendor. So I used the strikethrough feature 
of my word processor to indicate that these data elements should not be in- 
cluded. 

Finally, I identified the data elements that are included in two or more tables 
by coding an asterisk after them. Although you can use any notation you like for 
this step of the design process, you'll want to be sure that you document your 
design decisions. For a complicated design, you will probably want to use a 
CASE (computer-aided software engineering) tool. 

By the way, a couple of the new data elements I added may not be clear to 
you if you haven't worked with a corporate accounts payable system before. 
"Terms" refers to the payment terms that the vendor offers. For example, the 
terms might be net 30 (the invoice must be paid in 30 days) or might include a 
discount for early payment. "Account number" refers to the general ledger 
accounts that a company uses to track its expenses. For example, one account 
number might be assigned for advertising expenses, while another might be for 
office supplies. Each invoice that's paid is assigned to an account, and in some 
cases, different line items on an invoice are assigned to different accounts. 


Possible tables and columns for an accounts payable system 


Vendor name 
Vendor address 
Vendor city 
Vendor state 
Vendor zip code 


Vendor phone number 
Vendor-faxnumber 
Vendor-web-address 
Vendor contact first name 
Vendor contact last name 


Terms* 
Account number* 


Invoice number* 
Invoice date 
Terms* 

Invoice total 
Payment date 
Payment total 
Invoice due date 
Credit total 
Account number* 
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Invoice number* 
Htem-partnumber 
Item quantity 
Item description 
Item unit price 
Item extension 
Account number* 
Sequence number 


How to design a database 


Description 


After you identify and subdivide all of the data elements for a database, you should 
group them by the entities with which they’re associated. These entities will later be- 
come the tables of the database, and the elements will become the columns. 


If a data element relates to more than one entity, you can include it under all of the 
entities it relates to. Then, when you normalize the database, you may be able to remove 
the duplicate elements. 


As you assign the elements to entities, you should omit elements that aren’t needed, and 
you should add any additional elements that are needed. 


The notation used in this figure 


Data elements that were previously identified but aren’t needed are crossed out. 
Data elements that were added are displayed in italics. 
Data elements that are related to two or more entities are followed by an asterisk. 


You can use a similar notation or develop one of your own. You can also use a CASE 
(computer-aided software engineering) tool if one is available to you. 


Figure 9-4 How to identify the tables and assign columns 
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How to identify the primary and foreign keys 


Once you identify the entities and data elements of a system, the next step is 
to identify the relationships between the tables. To do that, you need to identify 
the primary and foreign keys as shown in figure 9-5. 

As you know, a primary key is used to uniquely identify each row in a table. 
In some cases, you can use an existing column as the primary key. For example, 
you might consider using the vendor, name column as the primary key of the 
Vendors table. Because the values for this column can be long, however, and 
because it would be easy to enter a value like that incorrectly, that's not a good 
candidate for a primary key. Instead, you should use an ID column like 
vendor. id that's incremented by one for each new record. 

Similarly, you might consider using the invoice, number column as the 
primary key of the Invoices table. However, it's possible for different vendors to 
use the same invoice number, so this value isn't necessarily unique. Because of 
that, another ID column like invoice id can be used as the primary key. 

To uniquely identify the rows in the Invoice Line Items table, this design 
uses a composite key. This composite key uses two columns to identify each 
row. The first column is the invoice id column from the Invoices table, and the 
second column is the invoice sequence column. This is necessary because this 
table may contain more than one row (line item) for each invoice. And that 
means that the invoice, id value by itself may not be unique. 

After you identify the primary key of each table, you need to identify the 
relationships between the tables and add foreign key columns as necessary. In 
most cases, two tables will have a one-to-many relationship with each other. For 
example, each vendor can have many invoices, and each invoice can have many 
line items. To identify the vendor that each invoice is associated with, a 
vendor. id column is included in the Invoices table. Because the 
Invoice Line Items table already contains an invoice id column, it's not 
necessary to add another column to this table. 

The diagram at the top of this figure illustrates the relationships I identified 
between the tables in the accounts payable system. As you can see, the primary 
keys are displayed in bold. Then, the lines between the tables indicate how the 
primary key in one table is related to the foreign key in another table. Here, a 
small, round connector indicates the one side of the relationship, and the 
connector with three lines indicates the many side of the relationship. 

In addition to the one-to-many relationships shown in this diagram, you can 
also use many-to-many relationships and one-to-one relationships. The second 
diagram in this figure, for example, shows a many-to-many relationship be- 
tween an Employees table and a Committees table. As you can see, this type of 
relationship can be implemented by creating a linking table, also called a 
connecting table or an associate table. This table contains the primary key 
columns from the two tables. Then, each table has a one-to-many relationship 
with the linking table. Notice that the linking table doesn't have its own primary 
key. Because this table doesn't correspond to an entity and because it's used 
only in conjunction with the Employees and Committees tables, a primary key 
isn't needed. 
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The relationships between the tables in the accounts payable system 


vendors Involces invoice line items 


vendor Іа Involce. Id d involce id 

vendor name vendor. id involce sequence 
vendor. address invoice number account no 

vendor. city invoice date line item, description 
vendor. state invoice, total item quantity 


vendor. zip code payment total item, unit, price 
vendor. phone credit total line. item. amount 
vendor. contact first name terms 

vendor. contact last name invoice due date 

terms payment. date 

account no account no 


Two tables with a many-to-many relationship 


employees memberships committees 


employee Id d employee id committee id 
first name committee id - committee name 
last name 


Linking table 
Two tables with a one-to-one relationship 


employees employee photos 


employee id employee Id 


first name employee. photo 
last name 


Description 


e Each table should have a primary key that uniquely identifies each row. If possible, you 
should use an existing column for the primary key. 

e The values of the primary keys should seldom, if ever, change. The values should also be 
short and easy to enter correctly. 

e Ifa suitable column doesn't exist for a primary key, you can create an ID column that is 
incremented by one for each new row as the primary key. 

e Iftwo tables have a one-to-many relationship, you may need to add a foreign key column 
to the table on the “many” side. The foreign key column must have the same data type as 
the primary key column it's related to. 

e Iftwo tables have a many-to-many relationship, you'll need to define a linking table to 
relate them. Then, each of the tables in the many-to-many relationship will have a one- 
to-many relationship with the linking table. The linking table doesn't usually have a 
primary key. 

e Iftwo tables have a one-to-one relationship, they should be related by their primary keys. 
This type of relationship is typically used to improve performance. Then, columns with 
large amounts of data can be stored in a separate table. 


Figure 9-5 How to identify the primary and foreign keys 
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The third example illustrates two tables that have a one-to-one relationship. 
With this type of relationship, both tables have the same primary key, which 
means that the information could be stored in a single table. This type of 
relationship is often used when a table contains one or more columns with large 
amounts of data. In this case, the Employee, Photos table contains a large binary 
column with a photo of each employee. Because this column is used infre- 
quently, storing it in a separate table will make operations on the Employees 
table more efficient. Then, when this column is needed, it can be combined with 
the columns in the Employees table using a join. 


How to enforce the relationships between tables 


Although the primary keys and foreign keys indicate how the tables in a 
database are related, the database management system doesn't always enforce 
those relationships automatically. In that case, any of the operations shown in 
the table at the top of figure 9-6 would violate the referential integrity of the 
tables. If you deleted a row from a primary key table, for example, and the 
foreign key table included rows related to that primary key, the referential 
integrity of the two tables would be destroyed. In that case, the rows in the 
foreign key table that no longer have a related row in the primary key table 
would be orphaned. Similar problems can occur when you insert a row into the 
foreign key table or update a primary key or foreign value. 

To enforce those relationships and maintain the referential integrity of the 
tables, Oracle provides for declarative referential integrity. To use it, you define 
foreign key constraints that indicate how the referential integrity between the 
tables is enforced. You'll learn more about defining foreign key constraints in 
the next chapter. For now, just realize that these constraints can prevent all of 
the operations listed in this figure that violate referential integrity. 
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Operations that can violate referential integrity 
This operation... Violates referential integrity if... 


Delete a row from the primary key table The foreign key table contains one or more rows related to the 
deleted row 


Insert a row in the foreign key table The foreign key value doesn't have a matching primary key 


value in the related table 


Update the value of a foreign key The new foreign key value doesn't have a matching primary key 
value in the related table 


Update the value of a primary key The foreign key table contains one or more rows related to the 
row that's changed 


Description 


e Referential integrity means that the relationships between tables are maintained cor- 
rectly. That means that a table with a foreign key doesn't have rows with foreign key 
values that don't have matching primary key values in the related table. 


e In Oracle, you can enforce referential integrity by using declarative referential integrity 
or by defining triggers. 

e To use declarative referential integrity (DRI), you define foreign key constraints. You'll 
learn how to do that in the next chapter. 


e When you define foreign key constraints, you can specify how referential integrity is 
enforced when a row is deleted from the primary key table. The options are to return an 
error, to delete the related rows in the foreign key table, or to set the foreign key values 
in the related rows to null. 


e If referential integrity isn't enforced and a row is deleted from the primary key table that 
has related rows in the foreign key table, the rows in the foreign key table are said to be 
orphaned. 


Figure 9-6 How to enforce the relationships between tables 
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How normalization works 


The next step in the design process is to review whether the data structure is 
normalized. To do that, you look at how the data is separated into related tables. 
If you follow the first four steps for designing a database that are presented in 
this chapter, your database will already be partially normalized when you get to 
this step. However, almost every design can be normalized further. 

Figure 9-7 illustrates how normalization works. The first two tables in this 
figure show some of the problems caused by an unnormalized data structure. In 
the first table, you can see that each row represents an invoice. Because an 
invoice can have one or more line items, however, the item description column 
must be repeated to provide for the maximum number of line items. But since 
most invoices have fewer line items than the maximum, this can waste storage 
space. 

In the second table, each line item is stored in a separate row. That elimi- 
nates the problem caused by repeating the item, description column, but it 
introduces a new problem: the invoice number must be repeated in each row. 
This, too, can cause storage problems, particularly if the repeated column is 
large. In addition, it can cause maintenance problems if the column contains a 
value that's likely to change. Then, when the value changes, each row that 
contains the value must be updated. And if a repeated value must be reentered 
for each new row, it would be easy for the value to vary from one row to an- 
other. 

To eliminate the problems caused by data redundancy, you can normalize 
the data structure. To do that, you apply the normal forms you'll learn about 
later in this chapter. As you'll see, there are a total of seven normal forms. 
However, it's common to apply only the first three. The diagram in this figure, 
for example, shows the accounts payable system in third normal form. Although 
it may not be obvious at this point how this reduces data redundancy, that will 
become clearer as you learn about the different normal forms. 


Chapter 9 Ноу to design a database 297 


А table that contains repeating columns 


INVOICE NLIMBER E ITEM, DESCRIPTION, 1 | ITEM DESCRIPTION, 2 E ITEM_DESCRIPTION_3 


1112697 VB ed SGL ad Library directory 
297/552 Catalogs SQL flyer (пи 
3975538 Card revision тий rmull) 


А table that contains redundant data 


INVOICE NUMBER |0 ITEM DESCRIPTION 


1112897 YB ad 

2112897 SQL ad 
3975335 Card revisions 
4112887 Library directory 
587/522 Catalogs 

B 977522 SQL flyer 


The accounts payable system in third normal form 


invoices 


vendors 


invoice line Items 


vendor. id involce id invoice id 

vendor name vendor. id involce sequence 
vendor address invoice number account no 

vendor. city invoice date lina item, amount 
vendor. state invoice total line item. description 
vendor zip code payment total 

vendor phone credit total 

vendor. contact first name terms, id 

vendor. contact last name invoice due date 

default terms id payment date 

default account no 


terms id 
terms description 
terms due days 


Description 


e Normalization is a formal process you can use to separate the data in a data structure into 
related tables. Normalization reduces data redundancy, which can cause storage and 
maintenance problems. 


e [пап unnormalized data structure, a table can contain information about two or more 
entities. It can also contain repeating columns, columns that contain repeating values, 
and data that's repeated in two or more rows. 


e Inanormalized data structure, each table contains information about a single entity, and 
each piece of information is stored in exactly one place. 


e To normalize a data structure, you apply the normal forms in sequence. Although there 
are a total of seven normal forms, a data structure is typically considered normalized if 
the first three normal forms are applied. 


Figure 9-7 How normalization works 


298 Section 3 Database design and implementation 


How to identify the columns to be indexed 


The last step in the design process is to identify the columns that should be 
indexed. Àn index is a structure that provides for locating one or more rows 
directly. Without an index, a database management system has to perform a 
table scan, which involves searching through the entire table. 

Just as the index of a book has page numbers that direct you to a specific 
subject, a database index has pointers that direct the system to a specific row. 
This can speed performance not only when you're searching for rows based on a 
search condition, but also when you're joining data from tables. If a join is done 
based on a primary key to foreign key relationship, for example, and an index is 
defined for the foreign key column, the database management system can use 
that index to locate the rows for each primary key value. 

When you use Oracle, an index is automatically created for the primary key 
in each table that you create. But you should consider creating indexes for other 
columns in some of the tables based on the guidelines at the top of figure 9-8. 

To start, you should index a column if it will be used frequently in search 
conditions or joins. Since you use foreign keys in most joins, you should 
typically index each foreign key column. The column should also contain 
mostly distinct values, and the values in the column should be updated infre- 
quently. If these conditions aren't met, the overhead of maintaining the index 
will probably outweigh the advantages of using it. 

When you create indexes, you should be aware that Oracle must update the 
indexes whenever you add, update, or delete rows. Because that can affect 
performance, you don't want to define more indexes than you need. 

As you identify the indexes for a table, keep in mind that, like a key, an 
index can consist of two or more columns. This type of index is called a com- 
posite index. 
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When to create an index 


When the column is a foreign key 

When the column is used frequently in search conditions or joins 
When the column contains a large number of distinct values 
When the column is updated infrequently 


Description 


Oracle automatically creates an index for a primary key. 

An index provides a way for a database management system to locate information more 
quickly. When it uses an index, the database management system can go directly to a 
specific row rather than having to search through all the rows until it finds it. 

Indexes speed performance when searching and joining tables. 

You can create composite indexes that include two or more columns. You should use this 
type of index when the columns in the index are updated infrequently or when the index 
will cover almost every search condition on the table. 


Because indexes must be updated each time you add, update, or delete a row, you 
shouldn't create more indexes than you need. 


Figure 9-8 How to identify the columns to be indexed 
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How to normalize a data structure 


The topics that follow describe the seven normal forms and teach you how 
to apply the first three. As I said earlier, you apply these three forms to some 
extent in the first four database design steps, but these topics will give you more 
insight into the process. Then, the last topic explains when and how to 
denormalize a data structure. When you finish these topics, you'll have the basic 
skills for designing databases that are efficient and easy to use. 


The seven normal forms 


Figure 9-9 summarizes the seven normal forms. Each normal form assumes 
that the previous forms have already been applied. Before you can apply the 
third normal form, for example, the design must already be in the second 
normal form. 

Strictly speaking, a data structure isn't normalized until it's in the fifth or 
sixth normal form. However, the normal forms past the third normal form are 
applied infrequently. Because of that, I won't present those forms in detail here. 
Instead, ГЇЇ just describe them briefly so you'll have an idea of how to apply 
them if you need to. 

The Boyce-Codd normal form can be used to eliminate transitive dependen- 
cies. With this type of dependency, one column depends on another column, 
which depends on a third column. To illustrate, consider the city, state, and zip 
code columns in the Vendors table. Here, a zip code identifies a city and state, 
which means that the city and state are dependent on the zip code. The zip code, 
in turn, is dependent on the vendor, id column. To eliminate this dependency, 
you could store the city and state values in a separate table that uses zip code as 
its primary key. 

The fourth normal form can be used to eliminate multiple multivalued 
dependencies from a table. A multivalued dependency is one where a primary 
key column has a one-to-many relationship with a non-key column. To illus- 
trate, consider the vendor contact phone number in the Vendors table. If you 
wanted to accommodate alternate phone numbers, such as a cellular or home 
phone, you could add extra columns for each type of number. However, this 
creates a multivalued dependency between the phone numbers and the 
vendor. id. To be in fourth normal form, therefore, you'd need to store phone 
numbers in a separate table that uses vendor, id as a foreign key. 

To apply the fifth normal form, you continue to divide the tables of the data 
structure into smaller tables until all redundancy has been removed. When 
further splitting would result in tables that couldn't be used to reconstruct the 
original table, the data structure is in fifth normal form. In this form, most tables 
consist of little more than key columns with one or two data elements. 

The domain-key normal form, sometimes called the sixth normal form, is 
only of academic interest since no database system has implemented a way to 
apply it. For this reason, even normalization purists might consider a database to 
be normalized in fifth normal form. 
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The seven normal forms 


First (INF) The value stored at the intersection of each row and column must be a scalar value, 
and a table must not contain any repeating columns. 

Second (2NF) Every non-key column must depend on the entire primary key. 

Third (3NF) Every non-key column must depend only on the primary key. 

Boyce-Codd (BCNF) A non-key column can’t be dependent on another non-key column. This prevents 
transitive dependencies, where column A depends on column C and column B 


depends on column C. Since both A and B depend on C, A and B should be moved 
into another table with C as the key. 


Fourth (4NF) A table must not have more than one multivalued dependency, where the primary 


key has a one-to-many relationship to non-key columns. This form gets rid of 
misleading many-to-many relationships. 

Fifth (SNF) The data structure is split into smaller and smaller tables until all redundancy has 
been eliminated. If further splitting would result in tables that couldn’t be joined to 
recreate the original table, the structure is in fifth normal form. 


Domain-key (DKNF) Every constraint on the relationship is dependent only on key constraints and 

or domain constraints, where a domain is the set of allowable values for a column. 

Sixth (6NF) This form prevents the insertion of any unacceptable data by enforcing constraints 
at the level of a relationship, rather than at the table or column level. DKNF is less 
a design model than an abstract "ultimate" normal form. 


The benefits of normalization 


e Since a normalized database has more tables than an unnormalized database, and since 
each table has an index on its primary key, the database has more indexes. That makes 
data retrieval more efficient. 


e Since each table contains information about a single entity, each index has fewer col- 
umns (usually one) and fewer rows. That makes data retrieval and insert, update, and 
delete operations more efficient. 


e Each table has fewer indexes, which makes insert, update, and delete operations more 
efficient. 


e Data redundancy is minimized, which simplifies maintenance and reduces storage. 


Description 
e Each normal form assumes that the design is already in the previous normal form. 


e A database is typically considered to be normalized if it is in third normal form. The 
other four forms are not commonly used and are not covered in detail in this book. 


Figure 9-9 The seven normal forms 
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Figure 9-9 also lists the benefits of normalizing a data structure. To summa- 
rize, normalization produces smaller, more efficient tables. In addition, it 
reduces data redundancy, which makes the data easier to maintain and reduces 
the amount of storage needed for the database. Because of these benefits, you 
should always consider normalizing your data structures. 

You should also be aware that the subject of normalization is a contentious 
one in the database community. In the academic study of computer science, 
normalization is considered a form of design perfection that should always be 
strived for. In practice, though, database designers and DBAs tend to use 
normalization as a flexible design guideline. 


How to apply the first normal form 


Figure 9-10 illustrates how you apply the first normal form to an 
unnormalized invoice data structure consisting of the data elements that are 
shown in figure 9-2. The first two tables in this figure illustrate structures that 
aren't in first normal form. Both of these tables contain a single row for each 
invoice. Because each invoice can contain one or more line items, however, the 
first table allows for repeating values in the item, description column. The 
second table is similar, except it includes a separate column for each line item 
description. Neither of these structures is acceptable in first normal form. 

The third table in this figure has eliminated the repeating values and col- 
umns. To do that, it includes one row for each line item. Notice, however, that 
this has increased the data redundancy. Specifically, the vendor name and 
invoice number are now repeated for each line item. This problem can be solved 
by applying the second normal form. 

Before I describe the second normal form, I want you to realize that I 
intentionally omitted many of the columns in the invoice data structure from the 
examples in this figure and the next figure. In addition to the columns shown 
here, for example, each of these tables would also contain the vendor address, 
invoice date, invoice total, etc. By eliminating these columns, it will be easier 
for you to focus on the columns that are affected by applying the normal forms. 
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The invoice data with a column that contains repeating values 


VENDOR МАМЕ INVOICE. NUMBER ITEM, DESCRIPTION 
1 Cahners Publishing 112897 VB ad, SGL ad, Library directory 


2 Zylka Design 97/522 Catalogs, SQL Flyer 
3 Zylka Design 97/5338 Card revision 


The invoice data with repeating columns 


VENDOR, NAME INVOICE NUMBER ITEM, DESCRIPTION, 1 ITEM, DESCRIPTION, 2 ITEM, DESCRIPTION, 3 
1 Cahners Publishing 112897 VB ad SQL ad Library directory 
2 Zyka Design 97/552 Catalogs SQL flyer (null) 
3 Zyka Design 97/5538 Card revision (ти (null) 


The invoice data in first normal form 


VENDOR, NAME INVOICE NUMBER ITEM, DESCRIPTION 
1 Cahners Publishing 112897 VB ad 
2Cahners Publishing 112897 SGL ad 


3Cahners Publishing 97/5338 Card revisions 

4 Zyka Design 112887 Library directory 
5 Zyka Design 97/522 Catalogs 

B Zylka Design 97/522 SQL flyer 


Description 


e Fora table to be in first normal form, its columns must not contain repeating values. 
Instead, each column must contain a single, scalar value. In addition, the table must not 
contain repeating columns that represent a set of values. 


e Atable in first normal form often has repeating values in its rows. This can be resolved 
by applying the second normal form. 


Figure 9-10 Ном to apply the first normal form 
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How to apply the second normal form 


Figure 9-11 shows how to apply the second normal form. To be in second 
normal form, every column in a table that isn't a key column must be dependent 
on the entire primary key. This form only applies to tables that have composite 
primary keys, which is often the case when you start with data that is com- 
pletely unnormalized. The table at the top of this figure, for example, shows the 
invoice data in first normal form after key columns have been added. In this 
case, the primary key consists of the invoice id and invoice sequence columns. 
The invoice sequence column is needed to uniquely identify each line item for 
an invoice. 

Now, consider the three non-key columns shown in this table. Of these 
three, only one, item, description, depends on the entire primary key. The other 
two, vendor. name and invoice, number, depend only on the invoice, id column. 
Because of that, these columns should be moved to another table. The result is a 
data structure like the second one shown in this figure. Here, all of the informa- 
tion related to an invoice is stored in the Invoices table, and all of the informa- 
tion related to an individual line item is stored in the Invoice Line Items table. 

Notice that the relationship between these tables is based on the invoice id 
column. This column is the primary key of the Invoices table, and it's the 
foreign key in the Invoice Line, Items table that relates the rows in that table to 
the rows in the Invoices table. This column is also part of the primary key of the 
Invoice Line Items table. 

When you apply second normal form to a data structure, it eliminates some 
of the redundant row data in the tables. In this figure, for example, you can see 
that the invoice number and vendor name are now included only once for each 
invoice. In first normal form, this information was included for each line item. 
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The invoice data in first normal form with keys added 


INVOICE Jb | VENDOR NAME | INVOICE NUMBER |) INVOICE SEQUENCE |) ITEM DESCRIPTION 
1 1 Cahners Publishing 112897 1 VB ad 
2 2 Cahners Publishing 112897 2 SQL ed 
3 3 Cahners Publishing 112897 3 Library directory 
4 4 Zylka Design 97/522 1 Catalogs 
$ $ Zylka Design 97/522 2 SQL flyer 
8 B Zylka Design 97/5338 1 Card revision 


The invoice data in second normal form 


@ imvoicE NuMBER |) veNboR wame [B] iwvoicE iD 
111287 Cahners Publishing 
2877522 Zylka Design 


3975338 Zylka Design 


@ voice |) mvoice_sequence |l]. ITEM_DESCRIPTION 
1 VB ad 
2 SQL ad 
3 Library directory 


1 Catalogs 
2 SQL flyer 
1 Card revision 


Description 


e Fora table to be in second normal form, every non-key column must depend on the 
entire primary key. If a column doesn’t depend on the entire key, it indicates that the 
table contains information for more than one entity. This is reflected by the table’s 
composite key. 


e To apply second normal form, you move columns that don’t depend on the entire pri- 
mary key to another table and then establish a relationship between the two tables. 


e Second normal form helps remove redundant row data, which can save storage space, 
make maintenance easier, and reduce the chance of storing inconsistent data. 


Figure 9-11 How to apply the second normal form 
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How to apply the third normal form 


To apply the third normal form, you make sure that every non-key column 
depends only on the primary key. Figure 9-12 illustrates how you can apply this 
form to the data structure for the accounts payable system. At the top of this 
figure, you can see all of the columns in the Invoices and Invoice, Line Items 
tables in second normal form. Then, you can see a list of questions that you 
might ask about some of the columns in these tables when you apply third 
normal form. 

First, does the vendor information depend only on the invoice id column? 
Another way to phrase this question is, ^Will the information for the same 
vendor change from one invoice to another?" If the answer is no, the vendor 
information should be stored in a separate table. That way, can you be sure that 
the vendor information for each invoice for a vendor will be the same. In 
addition, you will reduce the redundancy of the data in the Invoices table. This 
is illustrated by the diagram in this figure that shows the accounts payable 
system in third normal form. Here, a Vendors table has been added to store the 
information for each vendor. This table is related to the Invoices table by the 
vendor, id column, which has been added as a foreign key to the Invoices table. 

Second, does the terms column depend only on the invoice id column? The 
answer to that question depends on how this column is used. In this case, I'll 
assume that this column is used not only to specify the terms for each invoice, 
but also to specify the default terms for a vendor. Because of that, the terms 
information could be stored in both the Vendors and the Invoices tables. To 
avoid redundancy, however, the information related to different terms can be 
stored in a separate table, as illustrated by the Terms table in this figure. As you 
can see, the primary key of this table is an identity column named terms id. 
Then, a foreign key column named default terms id has been added to the 
Vendors table, and a foreign key column named terms, id has been added to the 
Invoices table. 

Third, does the account, no column depend only on the invoice, id column? 
Again, that depends on how this column is used. In this case, it's used to specify 
the general ledger account number for each line item, so it depends on the 
invoice id and the invoice sequence columns. In other words, this column 
should be stored in the Invoice, Line. Items table. In addition, each vendor has a 
default account number, which should be stored in the Vendors table. Because 
of that, another table named General, Ledger, Accounts has been added to store 
the account numbers and account descriptions. Then, foreign key columns have 
been added to the Vendors and Invoice Line Items tables to relate them to this 
table. 

Fourth, can the invoice due date column in the Invoices table and the 
line item. amount column in the Invoice Line. Items table be derived from 
other data in the database? If so, they depend on the columns that contain that 
data rather than on the primary key columns. In this case, the value of the 
line item amount column can always be calculated from the item quantity and 
item unit price columns. Because of that, this column could be omitted. 
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The accounts payable system in second normal form 


invoices Invoice_Iine_items 


involce_id Invoice_Id 

vendor_name invoice_date Involce sequence 

vendor. address invoice total account no 

vendor city payment total invoice, line, item, description 


vendor. state credit total item quantity 
vendor zip code terms item, unit price 
vendor phone invoice due, date line itern amount 
vendor, contact first name .— payment date 

vendor contact last name — account no 

invoice number 


Questions about the structure 


1. 


Does the vendor information (vendor name, vendor address, etc.) depend only on 
the invoice id column? 


2. Doesthe terms column depend only on the invoice id column? 


o 


Does the account, no column depend only on the invoice, id column? 


4. Canthe invoice due date and line item, amount columns be derived from other 


data? 


The accounts payable system in third normal form 


vendors 


invoices invoice line items 


vendor. id Involce id g Involce Іа 
vendor. name d vendor. id Involce sequence 
vendor. address invoice number g account no 
vendor. city invoice, date line item amount 
vendor. state invoice total line item description 
vendor zip code payment, total 

vendor, phone credit total 

vendor contact first name g terms id 
vendor. contact last name invoice due date 
default, terms, id payment, date general, ledger, accounts 


default account no account no 
account, description 


terms id 
terms description 
terms, due, days 


Description 


For a table to be in third normal form, every non-key column must depend only on the 
primary key. 

If a column doesn't depend only on the primary key, it implies that the column is as- 
signed to the wrong table or that it can be computed from other columns in the table. А 
column that can be computed from other columns contains derived data. 


Figure 9-12 Ном to apply the third normal form 


307 


308 Section 3 Database design and implementation 


Alternatively, you could omit the item, quantity and item unit price columns and 
keep just the line item, amount column. That's what I did in the data structure 
shown in this figure. The solution you choose, however, depends on how the data 
will be used. 

In contrast, although the invoice due date column could be calculated from 
the invoice date column in the Invoices table and the terms due days column in 
the related row of the Terms table, the system also allows this date to be overrid- 
den. Because of that, the invoice due, date column should not be omitted. If the 
system didn't allow this value to be overridden, however, this column could be 
safely omitted. 


When and how to denormalize a data structure 


Denormalization is the deliberate deviation from the normal forms. Most 
denormalization occurs beyond the third normal form. In contrast, the first three 
normal forms are almost universally applied. 

To illustrate when and how to denormalize a data structure, figure 9-13 
presents the design of the accounts payable system in fifth normal form. Here, the 
vendor zip codes are stored in a separate table that contains the city and state for 
each zip code. In addition, the area codes are stored in a separate table. Because of 
that, a query that retrieves vendor addresses and phone numbers would require 
two joins. In contrast, if you left the city, state, and area code information in the 
Vendors table, no joins would be required, but the Vendors table would be larger. 
In general, you should denormalize based on the way the data will be used. In this 
case, we'll seldom need to query phone numbers without the area code. Likewise, 
we'll seldom need to query city and state without the zip code. For these reasons, 
I've denormalized my design by eliminating the Zip. Codes and Area, Codes 
tables. 

You might also consider denormalizing a table if the data it contains is 
updated infrequently. In that case, redundant data isn't as likely to cause problems. 

Finally, you should consider including derived data in a table if that data is 
used frequently in search conditions. For example, if you frequently query the 
Invoices table based on invoice balances, you might consider including a column 
that contains the balance due. That way, you won't have to calculate this value 
each time it's queried. Keep in mind, though, that if you store derived data, it's 
possible for it to deviate from the derived value. For this reason, you may need to 
protect the derived column so it can't be updated directly. Alternatively, you could 
update the table periodically to reset the value of the derived column. 

Because normalization eliminates the possibility of data redundancy errors 
and optimizes the use of storage, you should carefully consider when and how to 
denormalize a data structure. In general, you should denormalize only when the 
increased efficiency outweighs the potential for redundancy errors and storage 
problems. Of course, your decision to denormalize should also be based on your 
knowledge of the real-world environment in which the system will be used. If 
you've carefully analyzed the real-world environment as outlined in this chapter, 
you'll have a good basis for making that decision. 
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The accounts payable system in fifth normal form 


vendors Invoices Invoice line items 


vendor id Invoice Id S Invoice Id 
vendor name vendor id Invoice sequence 
vendor. address invoice number account no 


vendor, zip code invoice date line item, qty 

vendor. area code id invoice, total line item, unit price 
vendor phone payment total line item, description id 
vendor contact first name credit total 

vendor. contact last name terms id 


default terms id invoice due date line Item descriptions 
default account no payment date — — 
line Item description id 


A] ЛА 


invoice, line item description 


z'p собе general ledger accounts 
city 
state account no 
account description 

area codes terms id —— 

terms description 
area code Id terms, due days 
area code 


When to denormalize 


When a column from a joined table is used repeatedly in search criteria, you should 
consider moving that column to the primary key table if it will eliminate the need for a 
join. 


If a table is updated infrequently, you should consider denormalizing it to improve 
efficiency. Because the data remains relatively constant, you don't have to worry about 
data redundancy errors once the initial data is entered and verified. 

Include columns with derived values when those values are used frequently in search 


conditions. If you do that, you need to be sure that the column value is always synchro- 
nized with the value of the columns it's derived from. 


Description 


Data structures that are normalized to the fourth normal form and beyond typically 
require more joins than tables normalized to the third normal form and can therefore be 
less efficient. 


SQL statements that work with tables that are normalized to the fourth normal form and 
beyond are typically more difficult to code and debug. 


Most designers denormalize data structures to some extent, usually to the third normal 
form. 


Denormalization can result in larger tables, redundant data, and reduced performance. 


Only denormalize when necessary. It is better to adhere to the normal forms unless it is 
clear that performance will be improved by denormalizing. 


Figure 9-13 — When and how to denormalize a data structure 
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Perspective 


Database design is a complicated subject. Because of that, it's impossible to 
teach you everything you need to know in a single chapter. With the skills you've 
learned in this chapter, however, you should now be able to design simple data- 
bases of your own. More important, you should be able to evaluate the design of 
any database that you work with. That way, you can be sure that the queries you 


code will be as efficient and as effective as possible. 


One aspect of database design that isn't covered in this chapter is designing the 
security of the database. Among other things, that involves creating database users 
and assigning permissions for each user. In chapter 12, you'll learn how to imple- 


ment database security. 


Terms 


data structure 

entity 

attribute 

instance 

entity-relationship (ER) modeling 
CASE (computer-aided software engineering) 
linking table 

connecting table 

associate table 

referential integrity 

declarative referential integrity (DRI) 


Exercises 


Design a database for tracking memberships 


foreign key constraint 
orphaned row 
normalization 

data redundancy 
unnormalized data structure 
normalized data structure 
normal forms 

index 

composite index 

derived data 
denormalization 


1. Draw a database diagram for a database that tracks the memberships for an 
association and for the groups within the association. Assume that each 
member can belong to any number of groups and that each group can have any 


number of members. 


2. Modify your design for exercise 2 to keep track of the role served by each 
individual in each group. Assume that each individual can only serve one role 
within a group and that each group has its own set of roles that members can 


fulfill. 
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How to create tables, 
indexes, and sequences 


Now that you've learned how to design a database, you're ready to learn how to 
implement your design. To do that, you use the set of SOL statements that are 
known as the data definition language (DDL). In this chapter, you'll learn how 
to use the DDL statements that work with tables, indexes, and sequences. 

This chapter begins by teaching you how to code these DDL statements 
yourself. This is useful because it’s common to store the DDL statements that 
create a database in a script. This chapter finishes by showing how to use 
SQL Developer to work with these database objects. 
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How to alter the constraints of a table .....s.ssssssesssssssussssssvssesonsrossosssneenvsesssss 322 
How to rename, truncate, and drop a table... sore erret rero nee 324 
How to work with indexes .......................................... 326 
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Howto воре: соем 326 
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Howto usea SEQUENCE слушай ийнаныр рынан 328 
a lon Atoe AAA a TE A A И а ET 330 
Howto rot EMG o eie nre tuer На siot eec Saaana 330 
The script used to create the AP schema ........................ 332 
An introduction tO SCEIDLS 1e. eere coeno cot nha cue INR oS NS RNANS MIB eut 332 
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How to work with tables 


This topic shows how to code the DDL statements that work with the tables 
of a database. If you're working on a large database project, you probably won't 
need to code DDL statements like these because that will be handled by a 
database administrator (DBA). For small projects, though, the SQL programmer 
may often have to serve as the DBA too. And even when working with large 
projects, the SQL programmer often needs to use DDL to create tables that are 
needed for testing. 

Because the syntax for the statements presented in this chapter is complex, 
this chapter doesn't present complete syntax diagrams for the statements. 
Instead, the diagrams present only the commonly used clauses. If you're inter- 
ested in the complete syntax of any statement, though, you can refer to the 
Oracle Database SQL Reference manual. 


How to create a table 


Figure 10-1 presents a simplified syntax for the CREATE TABLE state- 
ment. By default, this statement creates a new table in the current schema. If 
that's not what you want, you can qualify the table name with the schema name. 
For example, you can qualify the Vendors table with the EX schema like this: 

CREATE TABLE ex.vendors 


In its simplest form, the CREATE TABLE statement consists of the name of 
the new table followed by the names and data types of its columns. This is 
illustrated by the first example in this figure. However, in most cases, you'll 
code one or more attributes for each column as illustrated by the second ex- 
ample. For instance, to indicate that a column doesn't accept null values, you 
can code the NOT NULL attribute. If you omit this attribute, the column will 
allow null values. 

To indicate that each row in a column must contain a unique value, you can 
code the UNIQUE attribute. Since two null values aren't considered to be the 
same, a unique column can contain null values. However, it’s common to use 
the NOT NULL and UNIQUE attributes to define a column that can't contain 
null values and where each value in the column must be unique. 

Finally, to specify a default value for a column, you can use the DEFAULT 
attribute. This value is used if another value isn't specified when a row is added 
to the database. The default value you specify must correspond to the data type 
for the column. For example, the default value for the invoice, date column is 
set to the value that's returned by the SYSDATE function. Similarly, the default 
value for the payment total column is set to a value of zero. 

Before I continue, you should realize that if you run the statements shown 
in this figure against the AP schema, the statements will fail. That's because the 
AP schema already contains tables named Vendors and Invoices. As a result, if 
you want to test these statements, you can run them against the EX schema. 
Then, the Vendors and Invoices tables will be created in that schema. 


Chapter 10 Ноу to create tables, indexes, and sequences 


The syntax of the CREATE TABLE statement 


CREATE TABLE [schema name.]table name 

( 
column name 1 data type [column attributes] 
[, column name 2 data type [column attributes]]... 
[, table level constraints] 


) 


Common column attributes 
Attribute Description 


NOT NULL Indicates that the column doesn't accept null values. If omitted, the 
column can accept null values. 


UNIQUE Specifies that each value stored in the column must be unique. 
DEFAULT default value Specifies a default value for the column. 


А statement that creates a table without column attributes 


CREATE TABLE vendors 
( 
vendor id NUMBER, 
vendor name  VARCHAR2 (50) 
) 


А statement that creates a table with column attributes 


CREATE TABLE vendors 
( 
vendor id NUMBER NOT NULL UNIQUE, 
vendor name VARCHAR2 (50) NOT NULL UNIQUE 
) 


Another statement that creates a table with column attributes 


CREATE TABLE invoices 
( 


invoice id NUMBER NOT NULL UNIQUE, 
vendor id NUMBER NOT NULL, 
invoice number VARCHAR2 (50) NOT NULL, 
invoice date DATE DEFAULT SYSDATE, 
invoice total NUMBER (9, 2) NOT NULL, 
payment total NUMBER (9, 2) DEFAULT 0 
) 
Description 


e The CREATE TABLE statement creates a table based on the column definitions, column 
attributes, and table attributes you specify. 


e You can also assign one or more constraints to a column or to the entire table as de- 
scribed later in this chapter. 


e To review the complete syntax of the CREATE TABLE statement, you can use the 
Oracle Database SQL Reference manual. 


e To test the code in this figure and in the figures that follow, you can connect to the EX 
schema. 


Figure 10-1 How to create a table 
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If you review the CREATE TABLE syntax in figure 10-1, you'll see that 
you can code table-level constraints after the columns of the table. You'll see 
some examples of these constraints in figure 10-2. 


How to code a primary key constraint 


Whether you realize it or not, the NOT NULL and UNIQUE keywords are 
examples of constraints. À constraint restricts the type of data that can be stored 
in a column. For example, the NOT NULL keyword prevents null values from 
being stored in a column, and the UNIQUE keyword only allows unique values. 

Now, figure 10-2 shows how to code another type of constraint that's known 
as a primary key constraint. The easiest way to define a primary key is to code 
the PRIMARY KEY keywords after the data type for the column as shown in 
the first example. When you identify a column as the primary key, two of the 
column’s attributes are changed automatically. First, the column is forced to be 
NOT NULL. Second, the column is forced to contain a unique value for each 
row. In addition, an index is automatically created based on the column. 

Although the first example is the easiest way to code a primary key con- 
straint, it's generally considered a good programming practice to provide a 
name for the primary key constraint. This makes it easier to work with the 
constraint if that becomes necessary later on. To provide a name, you can use 
the CONSTRAINT keyword at the column level or at the table level. 

To show how to provide a name for a constraint, the second example uses 
the CONSTRAINT keyword to provide names for the three constraints that are 
defined in the first example. Here, the first constraint provides a name of 
vendors pk for the primary key of the Vendors table. Note how the names 
provided here begin with a table name or a column name and use a two-letter 
suffix to identify the type of constraint. Since these constraints are coded after 
the column name, they are known as column-level constraints. 

The third example shows how to code table-level constraints. In this figure, 
the vendors pk and vendor name uq constraints work the same regardless of 
whether they are coded at the column level or the table level. Аз a result, where 
you decide to code these constraints is largely a matter of personal preference. I 
prefer to name primary key and unique key constraints, and I prefer to code 
these constraints at the table level as shown in the third example. 

However, a table-level constraint does provide one capability that isn't 
available from column-level constraints: it can refer to multiple columns in the 
table. As a result, if you need to refer to multiple columns, you must use a table- 
level constraint. For example, to create a primary key based on two or more 
columns, you must code PRIMARY KEY at the table level as shown in the 
fourth example. 

When you code a constraint at the table level, you must code a comma at 
the end of the preceding column definition. If you don't, you will get an error 
when you try to run the statement. 
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The syntax of a column-level primary key constraint 
[CONSTRAINT constraint name] PRIMARY KEY 


The syntax of a table-level primary key constraint 


[CONSTRAINT constraint name] 
PRIMARY KEY (column name 1 [, column name 2]...) 


А table with column-level constraints 


CREATE TABLE vendors 
( 
vendor id NUMBER PRIMARY KEY, 
vendor name VARCHAR2 (50) NOT NULL UNIQUE 
) 


A table with named column-level constraints 


CREATE TABLE vendors 
( 
vendor id NUMBER CONSTRAINT vendors pk PRIMARY KEY, 
vendor name VARCHAR2 (50) CONSTRAINT vendor name nn NOT NULL 
CONSTRAINT vendor name un UNIQUE 
) 


A table with table-level constraints 


CREATE TABLE vendors 
( 
vendor id NUMBER, 
vendor name VARCHAR2 (50) NOT NULL, 
CONSTRAINT vendors pk PRIMARY KEY (vendor id), 
CONSTRAINT vendor name uq UNIQUE (vendor name) 
) 


A table with a two-column primary key constraint 


CREATE TABLE invoice line items 
( 

invoice id NUMBER NOT NULL, 

invoice sequence NUMBER NOT NULL, 

line item description VARCHAR2(100) NOT NULL, 

CONSTRAINT line items pk PRIMARY KEY (invoice id, invoice sequence) 
) 


Description 


e Constraints are used to enforce the integrity of the data in a table by defining rules about 
the values that can be stored in the columns of the table. 


e ‘You code a column-level constraint as part of the definition of the column it constrains. 
You code a table-level constraint as if it is a separate column definition, and you name 
the columns it constrains within that definition. 


e A not null constraint prevents null values from being stored in the column. A unique 
constraint requires that each row has a unique value in the column but allows null values 
to be stored in the column. 


e A primary key constraint requires that each row has a unique value for the column or 
columns for the primary key, and it does not allow null values. 


Figure 10-2 How to code a primary key constraint 
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How to code a foreign key constraint 


Figure 10-3 shows how to code a foreign key constraint, which is also 
known as a reference constraint. 'This type of constraint is used to define the 
relationships between tables and to enforce referential integrity. 

To create a foreign key constraint at the column level, you code the REFER- 
ENCES keyword followed by the name of the related table and the name of the 
related column in parentheses. In this figure, for instance, the first example 
creates a table with a vendor, id column that includes a REFERENCES clause 
that identifies the vendor id column in the Vendors table as the related column. 

The second example shows how to code the same primary and foreign key 
constraints shown in the first example at the table level. When you use this 
syntax, you must include the CONSTRAINT keyword followed by a name, 
followed by the FOREIGN KEY keywords. Although this requires a little more 
code, it forces you to provide a name for the foreign key, which is a good 
programming practice. It also lets you reference a foreign key that consists of 
multiple columns. 

The third example in this figure shows what happens when you try to insert 
a row into the Invoices table with a vendor id value that isn't matched by the 
vendor id column in the Vendors table. Because of the foreign key constraint, 
the system enforces referential integrity by refusing to do the operation. It also 
displays an error message that indicates the constraint that was violated. 

Similarly, if you try to delete a row from the Vendors table that has related 
rows in the Invoices table, the delete operation will fail and the system will 
display an error message. Since this prevents rows in the Invoices table from 
being orphaned, this is usually what you want. 

In some cases, though, you may want to automatically delete the related 
rows in the Invoices table when the related row in the Vendors table is deleted. 
To do that, you can code the ON DELETE clause with the foreign key con- 
straint as illustrated by the fourth example. Here, this clause is coded with the 
CASCADE option. Then, when you delete a row from the primary key table, the 
delete is cascaded to the related rows in the foreign key table. If, for example, 
you delete a row from the Vendors table, all related rows in the Invoices table 
will also be deleted. Because a cascading delete makes it easier to delete data 
that you didn't intend to delete, you should use it with caution. 

The other option for the ON DELETE clause is SET NULL. Then, when 
you delete a row from the primary key table, the values in the foreign key 
column of the foreign key table are set to null. Since this creates rows in the 
foreign key table that aren't related to the primary key table, you'll rarely want 
to use this option. 
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The syntax of a column-level foreign key constraint 


[CONSTRAINT constraint name] 
REFERENCES table name (column name) 
[ON DELETE (CASCADE|SET NULL)] 


The syntax of a table-level foreign key constraint 


[CONSTRAINT constraint name] 
FOREIGN KEY (column name 1 [, column name 2]...) 
REFERENCES table name (column name 1 [, column name 2]...) 
[ON DELETE (CASCADE|SET NULL)] 


A table with a column-level foreign key constraint 


CREATE TABLE invoices 
( 


invoice id NUMBER PRIMARY KEY, 
vendor id NUMBER REFERENCES vendors (vendor id), 
invoice number VARCHAR2 (50) NOT NULL UNIQUE 


) 


A table with a table-level foreign key constraint 


CREATE TABLE invoices 
( 


invoice id NUMBER NOT NULL, 
vendor id NUMBER NOT NULL, 
invoice number VARCHAR2 (50) NOT NULL UNIQUE, 


CONSTRAINT invoices pk 
PRIMARY KEY (invoice id), 
CONSTRAINT invoices fk vendors 
FOREIGN KEY (vendor id) REFERENCES vendors (vendor id) 
) 


An INSERT statement that fails because a related row doesn't exist 
INSERT INTO invoices 
VALUES (1, 1, '1') 
The response from the system 


SQL Error: ORA-02291: integrity constraint (EX.INVOICES FK VENDORS) violated 
- parent key not found 


*Cauge: A foreign key value has no matching primary key value. 
*Action: Delete the foreign key or add a matching primary key. 


A constraint that uses the ON DELETE clause 


CONSTRAINT invoices fk vendors 
FOREIGN KEY (vendor_id) REFERENCES vendors (vendor_id) 
ON DELETE CASCADE 


Description 


e A foreign key constraint requires values in one table to match values in another table. 
This defines the relationship between two tables and enforces referential integrity. 


e To define a relationship that consists of two or more columns, you must define the 
constraint at the table level. 


Figure 10-3 How to code a foreign key constraint 
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How to code a check constraint 


Figure 10-4 shows how to code a check constraint. À check constraint 
allows you to code a Boolean expression that checks values before they are 
stored in the column and only stores them if they satisfy the Boolean expres- 
sion. 

The first example in this figure uses a column-level check constraint to limit 
the values in the invoice, total column to numbers greater than zero. This works 
similarly to the constraints you saw in the previous figures. Note that if you try 
to store a negative value in this column as illustrated by the INSERT statement 
in the third example, the system responds with an error and the insert operation 
is terminated. 

The second example shows how to code the same constraint at the table 
level. Note how the AND keyword is used to combine both Boolean expressions 
into a single Boolean expression. Note also that this example provides a name 
of invoices ck for the constraint and that this name is used by the error message 
that's returned by the system. This shows why it's helpful to name your con- 
straints. 

In general, you should use check constraints to restrict the values in a 
column whenever possible. In some situations, however, check constraints can 
be too restrictive. Às an example, consider a telephone number that's con- 
strained to the (000) 000-0000" format used for US phone numbers. The 
problem with this constraint is that it doesn't let you store phone numbers with 
extensions (although you could store extensions in a separate column) or phone 
numbers with an international format. 

For this reason, check constraints aren't used by all database designers. That 
way, the database can store values with formats that weren't predicted when the 
database was designed. However, this flexibility comes at the cost of allowing 
some invalid data. For some systems, this tradeoff is acceptable. 

Keep in mind, too, that application programs that add and update data can 
also include data validation. In that case, check constraints may not be neces- 
sary. Because you can't always assume that an application program will check 
for valid data, though, you should include check constraints whenever that 
makes sense. 
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The syntax of a check constraint 
[CONSTRAINT constraint name] CHECK (condition) 


А statement that creates a table with two column-level check constraints 


CREATE TABLE invoices 
( 


invoice id NUMBER PRIMARY KEY, 
invoice total NUMBER (9, 2) NOT NULL CHECK (invoice_total >= 0), 
payment total NUMBER (9, 2) DEFAULT 0 CHECK (payment total >= 0) 


) 


The same statement with the check constraints coded at the table level 


CREATE TABLE invoices 
( 


invoice id NUMBER PRIMARY KEY, 
invoice total NUMBER (9, 2) NOT NULL, 
payment total NUMBER (9, 2) DEFAULT 0, 


CONSTRAINT invoices ck CHECK (invoice total >= 0 AND payment total >= 0) 
) 


An INSERT statement that fails due to the check constraint 


INSERT INTO invoices 


The response from the system 
SQL Error: ORA-02290: check constraint (EX.INVOICES CK) violated 


02290. 00000 - "check constraint (*8.*8) violated" 

*Cause: The values being inserted do not satisfy the named check 

*Action: do not insert values that violate the constraint. 
Description 


e Check constraints limit the values that can be stored in the columns of a table. 


e The condition you specify for a check constraint is evaluated as a Boolean expression. If 
the expression is true, the insert or update operation proceeds. Otherwise, it fails. 


e Acheck constraint that's coded at the column level can refer only to that column. A 
check constraint that's coded at the table level can refer to any column in the table. 


Figure 10-4 How to code a check constraint 
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How to alter the columns of a table 


After you create tables, you may need to change the columns of a table. For 
example, you may need to add, modify, or drop a column. To do that, you can 
use the ALTER TABLE statement shown in figure 10-5. 

The first example in this figure shows how to add a new column to a table. 
As you can see, you code the column definition the same way you do when you 
create a new table. To start, you specify the column name. Then, you code the 
data type and its attributes. 

The second example shows how to drop an existing column. Note that 
Oracle prevents you from dropping some columns. For example, you can't drop 
a column if it's the primary key column. 

The third example shows how to modify the length of the data type for an 
existing column. In this case, a column that was defined as VARCHAR2(50) is 
changed to VARCHAR2(100). Since the new data type is bigger than the old 
data type, you can be sure that the existing data will still fit. 

The fourth example shows how to change the data type to a different data 
type. In this case, a column that was defined as VARCHAR2(100) is changed to 
CHAR(100). Since these data types both store the same type of characters, you 
know that no data will be lost. 

The fifth example shows how to change the default value for a column. In 
this case, a default value of ‘New Vendor’ is assigned to the vendor name 
column. 

In the first five statements, Oracle can alter the table without losing any 
data. Аз a result, these statements execute successfully and alter the table. 
However, if the change will result in a loss of data, it's not allowed. For ex- 
ample, the sixth statement attempts to change the length of the vendor name 
column to a length that's too small for existing data that's stored in this column. 
As a result, Oracle doesn't modify the column, and the system returns an error 
message like the one shown in this figure. 
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The syntax for modifying the columns of a table 
ALTER TABLE [schema name.]table name 


{ 

ADD column name data type [column attributes] | 
DROP COLUMN column name | 

MODIFY column name data type [column attributes] 

) 


А statement that adds a new column 


ALTER TABLE vendors 
ADD last transaction date DATE; 


A statement that drops a column 


ALTER TABLE vendors 
DROP COLUMN last transac tion date; 


А statement that changes the length of a column 


ALTER TABLE vendors 
MODIFY vendor name VARCHAR2 (100); 


A statement that changes the data type of a column 


ALTER TABLE vendors 
MODIFY vendor name CHAR(100); 


А statement that changes the default value of a column 


ALTER TABLE vendors 
MODIFY vendor name DEFAULT 'New Vendor'; 


А statement that fails because it would cause data to be lost 


ALTER TABLE vendors 
MODIFY vendor name VARCHAR2 (10); 


The response from the system 
SQL Error: ORA-01441: cannot decrease column length because some value is 


too big 
Description 
e You can use the ALTER TABLE statement to modify the columns of an existing table. 
e Oracle won't allow you to change a column if that change would cause data to be lost. 


Warning 


e You should never alter a table or other database object in a production database without 
first consulting the DBA. 


Figure 10-5 How to alter the columns of a table 
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How to alter the constraints of a table 


After you create tables, you may need to change the constraints of a table. 
For example, you may need to add or drop a constraint. Or, you may want to 
disable or enable a constraint. 'To do that, you can use the ALTER TABLE 
command as shown in figure 10-6. 

The first example shows how to add a check constraint to a table. In this 
case, if the invoice total column contains existing values that don't satisfy the 
check constraint, Oracle won't add the check constraint and will return an error 
message. 

The second example shows how to drop the check constraint that was added 
in the first example. To do that, you have to know the name of the constraint. 
since I supplied a name for the constraint in the first example, it's easy to drop 
this constraint later. If you don't name your constraints, Oracle will automati- 
cally generate а name for the constraint such as S YS, C0012769. In that case, 
before you can drop a constraint, you'll need to use the SQL Developer tool to 
look up its name as shown later in this chapter. 

The third example shows how to use the DISABLE keyword to add a new 
check constraint that's disabled. Since this check constraint is disabled, Oracle 
won't check to make sure existing values satisfy this constraint. As a result, the 
constraint will be added even if there are existing values in the column that 
don't satisfy the constraint. 

The fourth example shows how to use the ENABLE and NOVALIDATE 
keywords to enable a constraint for new values only. In this case, the code 
enables the check constraint that was added in the third example without 
validating existing values against the check constraint. If you want to validate 
values when you enable the constraint, you can omit the NOVALIDATE key- 
word. 

The fifth example shows how to use the DISABLE keyword to disable an 
existing constraint. In some cases, this is useful if you need to temporarily 
disable a constraint while you update the data in the column. Then, you can 
enable the constraint when you're done. 

The last three examples show how to add other types of constraints. In 
particular, the sixth example shows how to add a foreign key constraint; the 
seventh example shows how to add a unique constraint; and the eighth example 
shows how to add a not null constraint. Note that a not null constraint uses a 
different syntax than the previous types of constraints. Note also that this syntax 
is a cross between the syntax for modifying a column and the syntax for modi- 
fying other types of constraints. 
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The syntax for modifying the constraints of a table 
ALTER TABLE table name 


ADD CONSTRAINT constraint name constraint definition [DISABLE] | 
DROP CONSTRAINT constraint name | 

ENABLE  [NOVALIDATE] constraint name | 

DISABLE constraint name 


А statement that adds a new check constraint 


ALTER TABLE invoices 
ADD CONSTRAINT invoice total ck CHECK (invoice total >m 0); 


А statement that drops a check constraint 


ALTER TABLE invoices 
DROP CONSTRAINT invoice total ck; 


А statement that adds a disabled constraint 


ALTER TABLE invoices 
ADD CONSTRAINT invoice total ck CHECK (invoice total >= 1) DISABLE; 


A statement that enables a constraint for new values only 


ALTER TABLE invoices 
ENABLE NOVALIDATE CONSTRAINT invoice total ck; 


А statement that disables a constraint 


ALTER TABLE invoices 
DISABLE CONSTRAINT invoice total ck; 


A statement that adds a foreign key constraint 


ALTER TABLE invoices 
ADD CONSTRAINT invoices fk vendors 
FOREIGN KEY (vendor id) REFERENCES vendors (vendor id); 


А statement that adds a unique constraint 


ALTER TABLE vendors 
ADD CONSTRAINT vendors vendor name uq 
UNIQUE (vendor name); 


А statement that adds a not null constraint 


ALTER TABLE vendors 
MODIFY vendor name 
CONSTRAINT vendors vendor name nn NOT NULL; 


Description 
e You use the ALTER TABLE statement to add or drop the constraints of an existing table. 


e To drop a constraint, you must know its name. If you don't know its name, you can use 
SQL Developer to look up the name as shown later in this chapter. 


e By default, Oracle verifies that existing data satisfies a new constraint. If that's not what 
you want, you can add a disabled constraint. Then, you can enable the constraint without 
validating existing data. 


Figure 10-6 How to alter the constraints of a table 
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How to rename, truncate, and drop a table 


Figure 10-7 shows how to use the RENAME, TRUNCATE TABLE, and 
DROP TABLE statements. When you use these statements, use them cautiously, 
especially when you're working on a production database. 

To start, you can use the RENAME statement to rename an existing table. 
This is useful if you want to change the name of a table without modifying its 
column definitions or the data that's stored in the table. In this figure, for 
instance, the first example changes the name of the Vendors table to Vendor. 
However, if you rename a table, you should probably update the names of any 
constraints that use the name of the table. 

On the other hand, you can use the TRUNCATE TABLE statement to delete 
all of the data from a table without deleting the column definitions for the table. 
In this figure, for instance, the second example deletes all rows from the newly 
renamed Vendor table. 

Finally, you can use the DROP TABLE statement to delete all of the data 
from a table and also delete the definition of the table, including the constraints 
for the table. In this figure, for instance, the third and fourth examples drop the 
Vendor table. However, the fourth example explicitly specifies that it is drop- 
ping the Vendor table that's stored in the EX schema, not the Vendor table in 
another schema such as the AP schema. 

When you issue a DROP TABLE statement, Oracle checks to see if other 
tables depend on the table you're trying to delete. If they do, Oracle won't allow 
the deletion. For example, you can't delete the Vendors table if a foreign key 
constraint in the Invoices table refers to the Vendors table. In that case, you must 
drop the Invoices table before you can drop the Vendors table. 

When you drop a table, any indexes or triggers that have been defined for 
the table are also dropped. In a moment, you'll learn how to create indexes for a 
table, and you'll learn how to create triggers for a table in chapter 16. 
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А statement that renames a table 


RENAME vendors TO vendor 


А statement that deletes all data from a table 


TRUNCATE TABLE vendor 


А statement that deletes a table from the current schema 


DROP TABLE vendor 


A statement that qualifies the table to be deleted 


DROP TABLE ex.vendor 


Description 


You can use the RENAME statement to change the name of an existing table. 


You can use the TRUNCATE TABLE statement to delete all data from a table without 
deleting the definition for the table. 


You can use the DROP TABLE statement to delete a table from the current database/ 
schema. To delete a table from another schema, you must qualify the table name with the 
schema name. 


You can't truncate or drop a table if a foreign key constraint in another table refers to that 
table. 


When you drop a table, all of its data, constraints, and indexes are deleted. 


Warnings 


You should not use these statements on a production database without first consulting the 
DBA. 


Figure 10-7 Ном to rename, truncate, and drop a table 
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How to work with indexes 


An index speeds up joins and searches by providing a way for a database 
management system to go directly to a row rather than having to search through 
all the rows until it finds the one you want. By default, Oracle creates indexes 
for the primary keys and unique constraints of a table, which is usually what 
you want. In addition, you may want to create indexes for foreign keys and 
other columns that are used frequently in search conditions or joins. However, 
you'll want to avoid creating indexes on columns that are updated frequently 
since this slows down insert, update, and delete operations. 


How to create an index 


Figure 10-8 presents the basic syntax of the CREATE INDEX statement, 
which creates an index based on one or more columns of a table. This syntax 
omits some of the optional clauses that you can use for tuning the indexes for 
better performance. This tuning is often done by DBAs working with large 
databases, but usually isn't necessary for small databases. 

To create an index, you name the table and columns that the index will be 
based on in the ON clause. For each column, you can specify the ASC or DESC 
keyword to indicate whether you want the index sorted in ascending or descend- 
ing sequence. If you don't specify a sort order, ASC is the default. In addition, 
you can use the UNIQUE keyword to specify that an index contains only unique 
values. 

In these examples, the names follow a standard naming convention that's 
used by many developers. To start, the index name specifies the name of the 
table, followed by the name of the column or columns, followed by a suffix of 
IX. The only exception in this figure is the second example, which had to be 
shortened so it wouldn't exceed the maximum number of characters allowed for 
a name. This naming convention makes it easy to see which columns of which 
tables have been indexed. 

The fifth and sixth examples show how to create a function-based index, 
which is an index that's based on an expression. This expression may include 
one or more functions. To enable function-based indexes, you may need to set 
the QUERY REWRITE ENABLED parameter for the system to true as shown 
in the seventh example. 


How to drop an index 


The eighth example shows how to use the DROP INDEX statement to drop 
an index. You may want to drop an index if you suspect that it isn't speeding up 
your joins and searches and that it may be slowing down your insert, update, 
and delete operations. 
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The syntax of the CREATE INDEX statement 


CREATE [UNIQUE] INDEX index name 
ON table name (column name 1 [ASC|DESC] [, column name 2 [ASC|DESC]]...) 


А statement that creates an index based on a single column 


CREATE INDEX invoices vendor id ix 
ON invoices (vendor id); 


А statement that creates an index based on two columns 


CREATE INDEX invoices vendor id inv no ix 
ON invoices (vendor id, invoice number); 


А statement that creates a unique index 


CREATE UNIQUE INDEX vendorsB vendor phone ix 
ON venders (vendor phone); 


А statement that creates an index that's sorted in descending order 


CREATE INDEX invoices invoice total ix 
ON invoices (invoice total DESC); 


А statement that creates a function-based index 


CREATE INDEX vendors vendor name upper ix 
ON vendors (UPPER(vendor name)); 


Another statement that creates a function-based index 


CREATE INDEX invoices balance due ix 
ON invoices (invoice total - payment total - credit total DESC); 


How to enable function-based indexes 


CONNECT system/system; 
ALTER SYSTEM SET QUERY REWRITE ENABLED=TRUE; 


А statement that drops an index 
DROP INDEX vendors vendor state ix 


Description 

e Oracle automatically creates an index for primary key constraints and for unique con- 
straints. 

e You can use the CREATE INDEX statement to create other indexes for a table. An index 
can improve performance when the Oracle searches for rows in the table. 


e You can use the CREATE INDEX statement to create function-based indexes for a table. 
А function-based index is an index that's based on an expression that may include one or 
more functions. 


e You can use the DROP INDEX statement to drop an index. 


Figure 10-8 How to create and drop an index 
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How to work with sequences 


In Oracle, a sequence is a database object that automatically generates a 
sequence of integer values. Typically, a sequence is used to generate a value for 
the primary key of a table. 


How to create a sequence 


Figure 10-9 shows how to create a sequence. Most of the time, you can 
create a sequence by coding the CREATE SEQUENCE statement followed by 
the name of the sequence. In the first example, for instance, the CREATE 
SEQUENCE statement creates a sequence named vendor_id_seq that can be 
used to get a value for the primary key of the Vendors table. 

This creates a Sequence that starts with 1, is incremented by a value of 1, 
has no maximum or minimum value, and caches the next 20 generated numbers. 
In addition, this sequence doesn’t cycle back to the first number when it reaches 
the last number in the sequence, and it doesn’t guarantee that sequence numbers 
are generated in order of request. In most cases, these settings are adequate. 

If you need to create a sequence that works differently, you can use any of 
the optional clauses of the CREATE SEQUENCE statement to modify the 
sequence. For example, the script that creates the AP database inserts 123 rows 
into the Vendors table. As a result, it makes sense to use the STARTS WITH 
clause to start the sequence that’s used to generate values for the vendor_id 
column at 124 or higher. 

Although you’ll rarely ever need to use the other clauses, the third example 
illustrates how these clauses work. This example generates a sequence that 
begins with 100, is incremented by a value of 10, has a minimum value of 0, has 
a maximum value of 1,000,000, cycles back to the beginning of the sequence 
when it reaches the end, and guarantees that sequence numbers are generated in 
order of request. 


How to use a sequence 


Once you’ve created a sequence, you typically use it within an INSERT 
statement as shown in the fourth example. Here, the NEXTVAL pseudo column 
gets the next value from the sequence so it can be inserted into the vendor_id 
column of the Vendors table. Then, the fifth example shows how to use the 
CURRVAL pseudo column to check the current value of the sequence. 

When you изе these pseudo columns, you should be aware that Oracle 
doesn’t initialize the sequence until you call the NEXTVAL pseudo column for 
the first time. As a result, you can’t call the CURRVAL pseudo column until 
you’ve called the NEXTVAL pseudo column at least once. 
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The syntax of the CREATE SEQUENCE statement 


CREATE SEQUENCB Sequence name 
[START WITH starting integer] 
[INCREMENT BY increment integer] 
[(MAXVALUE maximum integer | NOMAXVALUE)] 
[(MINVALUE minimum integer | NOMINVALUE)] 
[{CYCLE | NOCYCLE}] 
[(CACHE cache size|NOCACHE)] 
[ (ORDER | NOORDER}] 


А statement that creates a sequence of integers that starts with 1 and is 
incremented by 1 
CREATE SEQUENCE vendor id seq 


А statement that specifies a starting integer for a sequence 


CREATE SEQUENCE vendor id seq 
START WITH 124 


А statement that specifies all optional parameters for a sequence 


CREATE SEQUENCE test seq 
START WITH 100 INCREMENT BY 10 
MINVALUE 0 MAXVALUE 1000000 
CYCLE CACHE 10 ORDER; 


А statement that uses the NEXTVAL pseudo column to get the next value 
for a sequence 


INSERT INTO vendors 

VALUES (vendor id seq.NEXTVAL, 'Acme Co.', '123 Main St.', NULL, 
'Fresno!, 'CA', '93711', '(800) 221-5528', 
'Wiley' , 'Coyote'); 


A statement that uses the CURRVAL pseudo column to get the current 
value of the sequence 
SELECT vendor id seq.CURRVAL from dual; 


Description 

e ‘You use the CREATE SEQUENCE statement to generate integer values for a primary 
key. 

e By default, the CREATE SEQUENCE statement creates a sequence that starts with 1, is 
incremented by a value of 1, has no maximum or minimum value, caches the next 20 
generated numbers, doesn't restart the sequence when the end is reached, and doesn't 
guarantee that sequence numbers are generated in order of request. 


e ‘You can use the NEXTVAL pseudo column to get the next value in the sequence. 
e You can use the CURRVAL pseudo column to get the current value in the sequence. 


Figure 10-9 Ном to create and use a sequence (part 1 of 2) 
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How to alter a sequence 


Once you've created a sequence, you can use the ALTER SEQUENCE 
statement to alter the attributes of a sequence. This works similarly to the 
CREATE SEQUENCE statement. However, you can't change the starting value, 
and you can't set the minimum and maximum. attributes to values that don't 
make sense. For example, if the current value of the sequence is 99, you can't 
set the maximum value to 98. 


How to drop a sequence 


When you drop a table, all indexes related to the table are also dropped. 
However, the sequences that are used by the table aren't dropped. As a result, if 
you want to drop a sequence, you must use the DROP SEQUENCE statement. 
In this figure, for instance, the last example drops the sequence named test, seq 
that was created in part 1 of this figure. 
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The syntax of the ALTER SEQUENCE statement 


ALTER SEQUENCE Sequence name 
[Sequence attributes] 


A statement that alters a sequence 


ALTER SEQUENCE test seq 
INCREMENT BY 9 
MINVALUE 99 MAXVALUE 999999 
NOCYCLE CACHE 9 NOORDER; 


А statement that drops a sequence 
DROP SEQUENCE test seq; 


Description 


e ‘You can use the ALTER SEQUENCE statement to alter the attributes of a sequence. 
However, you can't change the starting value, and you can't set the minimum and 
maximum attributes to values that don't make sense. 


e ‘You can use the DROP SEQUENCE statement to drop a sequence. 


Figure 10-9 Ном to create and use a sequence (part 2 of 2) 
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The script used to create the AP 
schema 


Figure 10-10 presents the DDL statements that are used to create the AP 
schema that's used throughout this book. In this figure, these statements are 
coded as part of a script. 


An introduction to scripts 


As you learned in the earlier chapters, a script is a file that contains one or 
more SQL statements. In addition, a script can store PL/SQL code. Scripts are 
often used to create the objects for a database as shown in this figure. 

When you code a script, you code a semicolon at the end of each SQL 
statement. In addition, you code a front slash at the end of each block of PL/ 
SQL code that's stored in the script. At any point in the script, you can code a 
COMMIT statement to commit the changes to the database. However, DDL 
statements such as CREATE and DROP statements are automatically committed 
immediately after they’re executed. As a result, you don’t need to code a 
COMMIT statement after DDL statements like the ones shown in this figure. 


How the DDL statements work 


The CONNECT command that begins this script connects as the AP user 
with a password of AP. As a result, the rest of the statements in the script are 
executed against the AP schema. 

After the CONNECT command, an anonymous block of PL/SQL code is 
used to drop any existing sequences and tables that might already exist in the 
AP schema. Note that the DROP SEQUENCE and DROP TABLE statements 
are coded after the EXECUTE IMMEDIATE keywords within single quotes. 
This is necessary to execute DDL statements from within a block of PL/SQL 
code. At any rate, if these objects exist, this code drops them. If not, this code 
suppresses any error messages that would be displayed when you try to drop an 
object that doesn’t exist. 

After the block of PL/SQL code, a COMMIT statement is used to commit 
any changes that have been made to the database. For example, if the PL/SQL 
code dropped the sequences and tables, this statement will make sure that the 
changes are committed to the database. 

After the COMMIT statement, I have coded the CREATE TABLE state- 
ments for the five main tables of the AP schema. For each CREATE TABLE 
statement, I have coded the primary key column (or columns) first. Although 
this isn’t required, it’s a good programming practice. Since the order in which 
you declare the columns defines the default order for the columns, I have 
defined these columns in a logical order. That way, when you use a SELECT * 
statement to retrieve all of the columns, they’re returned in this order. 


Chapter 10 Ноу to create tables, indexes, and sequences 


The SQL script that creates the AP schema Page 1 
CONNECT ар/ар: 


-- Use an anonymous PL/SQL script to 
-- drop all tables and sequences in the current schema and 
== suppress any error messages that may be displayed 
-- if these objects don't exist 
BEGIN 
EXECUTE IMMEDIATE 'DROP SEQUENCE vendor id seq!; 
EXECUTE IMMEDIATE 'DROP SEQUENCE invoice id seq'; 


EXECUTE IMMEDIATE 'DROP TABLE invoice archive'; 
EXECUTE IMMEDIATE 'DROP TABLE invoice line items'; 
EXECUTE IMMEDIATE 'DROP TABLE invoices!; 
EXECUTE IMMEDIATE 'DROP TABLE vendor contacts!; 
EXECUTE IMMEDIATE 'DROP TABLE vendors'; 
EXECUTE IMMEDIATE 'DROP TABLE terms'; 
EXECUTE IMMEDIATE 'DROP TABLE general ledger_accounts'; 
EXCEPTION 
WHEN OTHERS THEN 
DBMS OUTPUT. PUT LINE(''); 
END; 
/ 


CREATE TABLE general ledger accounts 
( 
account number NUMBER NOT NULL, 
account description VARCHAR2 (50) NOT NULL, 
CONSTRAINT gl accounts pk 
PRIMARY KEY (account number), 
CONSTRAINT gl account description uq 
UNIQUE (account description) 
); 


CREATE TABLE terms 
( 


terms id NUMBER NOT NULL, 
terms description VARCHAR2 (50) NOT NULL, 
terms due days NUMBER NOT NULL, 


CONSTRAINT terms_pk 
PRIMARY KEY (terms id) 


Figure 10-10 The script used to create the AP schema (part 1 of 3) 
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When you create tables, you must create the tables that don't have foreign 
keys first. That way, the other tables can define foreign keys that refer to them. 
In this figure, for example, you can see that I created the Terms and 
General Ledger Accounts tables first since they don't have foreign keys. Then, 
I coded the Vendors table, which has foreign keys that refer to these tables. And 
so ОП. 

Conversely, when you drop tables, you must drop the last table that was 
created first. Then, you can work back to the first table that was created. Other- 
wise, the foreign keys might not allow you to delete the tables. In this figure, for 
example, the PL/SQL script deletes the Invoice_Line_Items table and works 
back from there. 

For most of the columns in these tables, I have coded a NOT NULL con- 
straint ог а DEFAULT attribute. In general, I only allow a column to accept null 
values when I want to allow for unknown values. If, for example, a vendor 
doesn’t supply an address, the address is unknown. In that case, you can store a 
null value in the vendor. address] and vendor_address2 columns. 

Another option is to store an empty string for these columns. To do that, I 
could have defined the vendor address columns like this: 

vendor addressl VARCHAR2 (50) DEFAULT '!, 

vendor address2 VARCHAR2 (50) DEFAULT '', 

In this case, empty strings will be stored for these columns unless other values 
are assigned to them. 

In practice, a null value is a more intuitive representation of an unknown 
value than a default value is. Conversely, it makes sense to use a default value 
like an empty string to indicate that a value is known but the column is empty. 
For example, an empty string might indicate that a vendor hasn't provided its 
street address. Although how you use nulls and empty strings is largely a matter 
of personal preference, it does of course affect the way you query a table. 


Chapter 10 


How to create tables, indexes, and sequences 


The SQL script that creates the AP schema 


CREATE TABLE vendors 
( 


vendor id NUMBER NOT 
vendor name VARCHAR2 (50) NOT 
vendor addressi VARCHAR2 (50), 
vendor address2 VARCHAR2 (50), 
vendor city VARCHAR2 (50) NOT 
vendor state CHAR (2) NOT 
vendor zip code VARCHAR2 (20) NOT 
vendor phone VARCHAR2 (50), 
vendor contact last name VARCHAR2 (50), 
vendor contact first name VARCHAR2 (50), 
default terms id NUMBER NOT 
default account number NUMBER NOT 


CONSTRAINT vendors pk 
PRIMARY KEY (vendor id), 
CONSTRAINT vendors vendor name uq 
UNIQUE (vendor name), 
CONSTRAINT vendors fk terms 
FOREIGN KEY (default terms id) 
REFERENCES terms (terms id), 
CONSTRAINT vendors fk accounts 


FOREIGN KEY (default account number) 


NULL, 
NULL, 


NULL, 
NULL, 
NULL, 


NULL, 
NULL, 


REFERENCES general ledger accounts (account number) 


); 


CREATE TABLE invoices 
( 


invoice id NUMBER 
vendor id NUMBER 
invoice number VARCHAR2 (50) 
invoice date DATE 
invoice total NUMBER (9, 2) 
payment total NUMBER (9, 2) 
credit total NUMBER (9, 2) 
terms id NUMBER 
invoice due date DATE 
payment date DATE, 


CONSTRAINT invoices pk 
PRIMARY KEY (invoice id), 
CONSTRAINT invoices fk vendors 
FOREIGN KEY (vendor id) 
REFERENCES vendors (vendor id), 
CONSTRAINT invoices fk terms 
FOREIGN KEY (terms id) 
REFERENCES terms (terms id) 


NOT 
NOT 
NOT 
NOT 
NOT 


NOT 
NOT 


NULL, 
NULL, 
NULL, 
NULL, 
NULL, 


NULL, 
NULL, 


DEFAULT 0, 
DEFAULT 0, 


Figure 10-10 The script used to create the AP schema (part 2 of 3) 
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Since Oracle automatically creates an index for each primary key and 
unique constraint, I provided names for all primary key and unique constraints. I 
also followed a strict convention for naming these constraints that begins with 
the name of the table or an abbreviated name for the table. 

In addition to the indexes that are created automatically, I used CREATE 
INDEX statements to create six more indexes to improve the performance of the 
database. Here again, I followed the naming conventions that I used for the 
primary key and unique constraints. As a result, if you view the indexes for the 
schema as shown later in this chapter, it's easy to determine how the indexes 
relate to the tables. 

As you review this script, note that the first five of these indexes are based 
on the foreign keys that each referring table uses to relate to another table. For 
example, since the vendor. id column in the Invoices table refers to the 
vendor id column in the Vendors table, I created an index on vendor. 14 in the 
Invoices table. Finally, I created an index for the invoice date column in the 
Invoices table because this column is frequently used to search for rows in this 
table. 

After the indexes, I coded the CREATE SEQUENCE statements for the 
sequences that are used for the Vendors and Invoices tables. These statements 
use the STARTS WITH clause to specify a starting number that's larger than the 
existing primary key values for these tables. To get the starting values, I checked 
the INSERT statements that are used to initially populate the database. Although 
these statements aren't shown in this figure, they are coded in the script that 
creates the AP schema after the DDL statements that are shown in this figure. 
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The SQL script that creates the AP schema Page 3 
CREATE TABLE invoice line items 
( 
invoice id NUMBER NOT NULL, 
invoice sequence NUMBER NOT NULL, 
account number NUMBER NOT NULL, 
line item amt NUMBER (9 , 2) NOT NULL, 


line item description VARCHAR2(100) NOT NULL, 
CONSTRAINT line items pk 

PRIMARY KEY (invoice id, invoice sequence), 
CONSTRAINT line items fk invoices 

FOREIGN KEY (invoice id) REFERENCES invoices (invoice id), 
CONSTRAINT line items fk acounts 

FOREIGN KEY (account number) 

REFERENCES general ledger accounts (account number) 
); 


-- Create the indexes 
CREATE INDEX vendors terms id ix 
ON vendors (default terms id); 
CREATE INDEX vendors account number ix 
ON vendors (default account number); 


CREATE INDEX invoices vendor id ix 
ON invoices (vendor id); 
CREATE INDEX invoices terms id ix 
ON invoices (terms id); 
CREATE INDEX line items account number ix 
ON invoice line items (account number); 
CREATE INDEX invoices invoice date ix 
ON invoices (invoice date DESC); 


-- Create the sequences 

CREATE SEQUENCE vendor id seq 
START WITH 124; 

CREATE SEQUENCE invoice id seq 
START WITH 115; 


Description 


Instead of creating database objects one at a time, you can write a script that contains all 
of the statements needed to create the tables, indexes, sequences, and other database 
objects for a schema. 


Each SQL statement in the script ends with a semicolon. 
Each block of PL/SQL code ends with a front slash (/). 


When you create tables, you must create the tables that don't have foreign keys first. 
That way, the other tables can define foreign keys that refer to them. 


When you drop tables, you start by dropping the last table that was created and then 
work back to the first table that was created. Otherwise, the foreign keys might not allow 
you to delete the tables. 


Figure 10-10 The script used to create the AP schema (part 3 of 3) 
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How to use SQL Developer 


Since you often use a script to create tables and other database objects, it's 
important to understand the DDL skills presented in this chapter. Once you 
understand these skills, it's easy to learn how to use a graphical user interface 
such as SQL Developer to work with database objects such as tables, indexes, 
and sequences. For example, it's often useful to view these database objects 
before writing SELECT, INSERT, UPDATE, or DELETE statements that use 
them. 


How to work with the columns of a table 


Figure 10-11 shows how to work with the column definitions of a table. To 
start, you can view the column definitions for a table by clicking on the table to 
display it in the main window. In this figure, for example, the Invoices table is 
shown in the main window. Here, you can see the name, data type, and other 
attributes of each column in the Invoices table. For example, you can see that 
the payment, total and credit, total columns specify a default value of 0. In 
addition, the payment, date column allows null values. As a result, you don't 
need to specify these columns in an INSERT statement for this table. 

If you want to modify the definition for a column, you can right-click on the 
table and select the Edit command. Then, you can use the resulting dialog box 
to edit the column or columns that you want to edit. Although this dialog box 
isn't shown in this figure, you shouldn't have any trouble using it if you under- 
stand the DDL statements presented earlier in this chapter. 

If you need to add a new table, you can right-click on the Tables folder and 
select the New Table command. Then, you can use the resulting dialog box to 
create a new table. Again, you shouldn't have any trouble using this dialog box 
if you understand how to use DDL to create a table. 


How to work with the data of a table 


When you view the column definitions of a table, you use the Columns tab 
of the main window. Then, if you want to view the data for a table, you can 
click on the Data tab. You can also use the buttons at the top of this tab to insert 
new rows, update the data in existing rows, and delete existing rows. 
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Description 
e To view the column definitions for a table, click on the table to display it in the main 
window. 


e To modify the definition for a column, right-click on the table and select the Edit com- 
mand. Then, use the resulting dialog box to edit the column or columns that you want to 
edit. 

e To add a new table, right-click on the Tables folder and select the New Table command. 
Then, use the resulting dialog box to create a new table. 


e To work with the data for a table, click on the table to display it in the main window, and 
click on the Data tab. Then, you can view the data for the table, and you can insert, 
update, and delete rows. 


Figure 10-11 How to work with the columns of a table 
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How to work with the constraints of a table 


Figure 10-12 shows how to work with the constraints of a table. To start, 
you can view the constraints for a table by clicking on the table to display it in 
the main window and then clicking on the Constraints tab. In this figure, for 
example, you can see the constraints for the Invoices table. Here, the primary 
key and foreign key constraints have been named, but the not null constraints 
haven't been named. As a result, Oracle has generated names for these con- 
straints that begin with SYS, C. Note that these not null constraints are actually 
check constraints that don't allow null values to be stored in these columns. 

Although there are several ways to work constraints, one of the easiest is to 
right-click on the table and select the Edit command. Then, you can use the 
resulting dialog box to add a new constraint, to modify an existing constraint, or 
to drop an existing constraint. This dialog box contains categories that allow 
you to work with primary key, foreign key, unique, and check constraints. 
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Description 


e To view the constraints for a table, click on the table to display it in the main window, 
and click on the Constraints tab. Then, you can view the constraints for the table, add a 
new constraint, and alter or drop an existing constraint. 


e To work with the constraints for a table, right-click on the table and select the Edit 
command. Then, you can use the resulting dialog box to work with the primary key, 
foreign key, unique, and check constraints of the table. 


Figure 10-12 How to work with the constraints of a table 
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How to work with indexes 


Figure 10-13 shows how to work with the indexes of a schema. To start, you 
can view all the indexes for the schema by expanding the Indexes folder. Then, 
you can get more information about a particular index by clicking on it to 
display it in the main window. In this figure, for example, all indexes for the AP 
schema are shown and the index named invoices, pk is displayed in the main 
window. 

Since the script that created the AP schema starts the name for each index 
with the name of its table, it's easy to find the index that you're looking for. In 
addition, the suffixes that are used for primary keys (PK), unique keys (UQ), 
and indexes (IX) make it easy to see which indexes were automatically gener- 
ated because they are primary keys or unique keys, and which indexes were 
created with the CREATE INDEX statement. For example, the index named 
invoices pk is an index for a primary key, and the index named 
invoices invoice date ix was created with the CREATE INDEX statement. 

If you don't begin index names with the table name, it can be difficult to 
determine which table contains an index. In that case, you can view the indexes 
for a particular table by expanding the Tables folder and clicking on the table to 
display it in the main window. Then, you can click on the Indexes tab to display 
the indexes for the table. 

If you want to work with an existing index, you can right-click on the index, 
select the appropriate command, and respond to the resulting dialog box. For 
example, to edit an index, right-click on the index, select the Edit command, 
and use the resulting dialog box to edit the index. 

Finally, if you want to add a new index, you can right-click on the Indexes 
folder and select the New Index command. Then, you can use the resulting 
dialog box to add the index. 
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Description 


e To view all indexes for a schema, expand the Indexes folder. Then, to get more informa- 
tion about a particular index, click on it to display it in the main window. 
e To view the indexes for a particular table, expand the Tables folder and click on the table 


to display it in the main window. Then, click on the Indexes tab to display the indexes for 
the table. 


e To edit an index, right-click on the index and select the Edit command. Then, use the 
resulting dialog box to edit the index. 


e To drop an index, right-click on the index and select the Drop command. Then, use the 
resulting dialog box to confirm the drop. 


e To add a new index, right-click on the Indexes folder and select the New Index com- 
mand. Then, use the resulting dialog box to add the index. 


Figure 10-13 How to work with indexes 
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How to work with sequences 


Figure 10-14 shows how to work with the sequences of a schema. To start, 
you can view the sequences for a schema by expanding the Sequences folder. 
Then, you can get more details about a sequence by clicking on the name of the 
sequence to display it in the main window. In this figure, for example, you can 
see the sequence that's used to generate values for the invoice, id column of the 
Invoices table. 

If you want to work with an existing sequence, you can right-click on the 
sequence, select the appropriate command, and use the resulting dialog box to 
finish the command. For example, to drop a sequence, right-click on the se- 
quence and select the Drop command. Then, use the resulting dialog box to 
confirm the drop. 

Finally, if you want to add a new sequence, you can right-click on the 
Sequences folder and select the New Sequence command. Then, you can use the 
resulting dialog box to add the sequence. 
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Description 

e To view the sequences for a schema, expand the Sequences folder. Then, to get more 
information about a sequence, click on the name of the sequence to display it in the main 
window. 

e To edit a sequence, right-click on the sequence and select the Edit command. Then, use 
the resulting dialog box to edit the sequence. 

e To drop a sequence, right-click on the sequence and select the Drop command. Then, use 
the resulting dialog box to confirm the drop. 


e To add а new sequence, right-click on the Sequences folder and select the New Sequence 
command. Then, use the resulting dialog box to add the sequence. 


Figure 10-14 How to work with sequences 
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Perspective 


Now that you've completed this chapter, you should be able to create and 
modify the tables, indexes, and sequences of a schema by coding DDL statements. 
In addition, you should be able to use a graphical tool like SQL Developer to work 
with the tables, indexes, and sequences of a schema. In the next two chapters, 
you'll learn how to use both of these techniques to work with other types of 
database objects. 

Before you move on, though, take a moment to consider the advantages and 
disadvantages of using SQL Developer to work with database objects like tables, 
indexes, and sequences. The advantage, of course, is that SQL Developer provides 
a graphical user interface that makes it easy to view and work with database 
objects. The disadvantage is that there is no record of any changes that you make 
to the database. For example, if you add a column to a table, that change isn't 
stored anywhere for future use. 

In contrast, if you use a script to add a column to a table, that change is stored 
for future use. This makes it easy to recreate the database if you ever need to do 
that. And that's why it's common to use scripts to make any changes to the struc- 
ture of a database. On the other hand, the SQL Developer is an excellent tool for 
quickly viewing the objects of a database or for quickly creating temporary tables 
or other objects that won't need to be recreated later. 


Terms 
attribute reference constraint 
constraint cascading delete 
column-level constraint check constraint 
table-level constraint index 
not null constraint function-based index 
unique constraint sequence 
primary key constraint script 
foreign key constraint database object 
Exercises 


Add constraints and an index to the AP schema 

1. Write an ALTER TABLE statement that adds two new check constraints to the 
Invoices table of the AP schema. The first should allow (1) payment, date to be 
null only if payment, total is zero and (2) payment, date to be not null only if 
payment total is greater than zero. The second constraint should prevent the 
sum of payment, total and credit total from being greater than invoice, total. 


2. Add an index to the AP schema for the zip code field in the Vendors table. 
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Implement a database design 
3. Write the CREATE TABLE statements needed to implement the following 
design in the EX schema: 


groups 


group. Id 
group name 


These tables provide for members of an association, and each member can be 
registered in one or more groups within the association. There should be one row 
for each member in the Members table and one row for each group in the 
Groups table. The member ID and group ID columns are the primary keys for 
the Members and Groups tables. And the Members Groups table relates each 
member to one or more groups. 


When you create the tables, be sure to include the key constraints. Also, include 
any null or default constraints that you think are necessary. 


4. Write INSERT statements that add two rows to the Members table for member 
IDs 1 and 2, two rows to the Groups table for group IDs 1 and 2, and three rows 
to the Group Membership table: one row for member 1 and group 2; one for 
member 2 and group 1; and one for member 2 and group 2. Then, write a 
SELECT statement that joins the three tables and retrieves the group name, 
member last name, and member first name. 


5. Create sequences that can be used to number the member ID and group ID 
values starting with 3 (since you already added members and groups for IDs 1 
and 2). 


6. Write an INSERT statement that adds another row to the Groups table. This 
statement should use the NEXTVAL pseudo column to get the value for the next 
group ID from the sequence that you created in exercise 5. Then, write a 
SELECT statement that gets all of the data for all of the rows in the Groups table 
to make sure your sequence worked correctly. 


7. Write an ALTER TABLE statement that adds two new columns to the Members 
table: one column for annual dues that provides for three digits to the left of the 
decimal point and two to the right; and one column for the payment date. The 
annual dues column should have a default value of 52.50. 


8. Write an ALTER TABLE statement that modifies the Groups table so the group 
name in each row has to be unique. Then, re-run the INSERT statement that you 
used in exercise 6 to make sure this works. 
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How to create views 


As you've seen throughout this book, SELECT queries can be complicated, 
particularly if they use multiple joins, subqueries, or complex functions. 
Because of that, you may want to save the queries you use regularly. One way 
to do that is to store the statement in a script file. Another way is to create a 
view. 

Unlike scripts, which are stored in files, views are stored as part of the 
database. As a result, they can be used by SQL programmers and by custom 
applications that have access to the database. This provides some advantages 
over using tables directly. 
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An introduction to views 


Before you learn the details for working with a view, it's helpful to get a 
general idea of how a view works. In addition, it's helpful to consider some of 
the benefits of views so you can determine whether you want to use them. 


How views work 


A view is a SELECT statement that's stored in the database as a database 
object. To create a view, you use a CREATE VIEW statement like the one 
shown in figure 11-1. This statement creates a view named vendors min that 
retrieves the vendor, name, vendor, state, and vendor, phone columns from the 
Vendors table. 

You can think of a view as a virtual table that consists only of the rows and 
columns specified in its CREATE VIEW statement. The table or tables that are 
listed in the FROM clause are called the base tables for the view. Since the view 
refers back to the base tables, it doesn't store any data itself, and it always 
reflects the most current data in the base tables. 

To use a view, you refer to it from another SQL statement. In this figure, for 
example, the SELECT statement uses the vendors min view in the FROM 
clause instead of a table. As a result, this SELECT statement extracts its result 
set from the virtual table that the view represents. In this case, all the rows for 
vendors in California are retrieved from the view. 

When you create a view like the one in this figure, the view is updateable. 
As a result, it's possible to use the view in an INSERT, UPDATE, or DELETE 
statement. In this figure, for example, the UPDATE statement uses the 
vendors min view to update the vendor, phone column in the Vendors table for 
the specified vendor. 

To drop a view, you can use the DROP VIEW statement as shown in this 
figure. This works similarly to the DROP statements for tables, indexes, and 
sequences that you learned about in the previous chapter. 

Because a view is stored as an object in a database, it can be used by anyone 
who has access to the database. That includes users who have access to the 
database through applications that provide for ad hoc queries and report genera- 
tion. In addition, that includes custom applications that are written specifically 
to work with the data in the database. In fact, views are often designed to be 
used with these types of applications. 
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A CREATE VIEW statement for a view named Vendors Min 


CREATE VIEW vendors min AS 
SELECT vendor name, vendor state, vendor phone 
FROM vendors; 


The virtual table that's represented by the view 


VENDOR, NAME 
1 US Postal Service 
2 National Information Data Ctr 
3 Registar of Copyrights NULL 
4 Jobtrak (800) 555-8725 
5 Newbrige Book Clubs (800) 555-9980 


(122 rows) 


VENDOR, STATE |] VENDOR_PHONE 
(800) 555-1205 
(301) 555-8950 


А SELECT statement that uses the Vendors Min view 


SELECT * FROM vendors min 
WHERE vendor state = !СА! 
ORDER BY vendor name 


The result set that's returned by the SELECT statement 


VENDOR, NAME VENDOR, STATE VENDOR, PHONE 


1 ASC Signs 
2 Abbey Office Furnishings 


3 American Express 
4 Aztek Label 
5 BFI Industries 


NULL 

(559) 555-8300 
(800) 555-3344 
(714) 555-9000 
(559) 555-1551 


(75 rows) 


An UPDATE statement that uses a view to update the base table 


UPDATE vendors min 
SET vendor phone = '(800) 555-3941' 
WHERE vendor name = 'Register of Copyrights' 


The response from the system 
1 rows updated 


A statement that drops a view 
DROP VIEW vendors min 


Description 


e А view consists of a SELECT statement that’s stored as an object in the database. The 
tables referenced in the SELECT statement are called the base tables for the view. 

e When you create a view, you can refer to the view anywhere you would normally use a 
table in any of the data manipulation statements: SELECT, INSERT, UPDATE, and 
DELETE. 


e Although a view behaves like a virtual table, it doesn’t store any data. Instead, a view 
always refers back to its base tables. 


e A view can also be referred to as a viewed table because it provides a view to the under- 
lying base tables. 


Figure 11-1 How views work 
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Benefits of using views 


Figure 11-2 describes some of the advantages of using views. To start, you 
can use views to limit the exposure of the tables in your database to external 
users and applications. To illustrate, suppose a view refers to a table that you've 
decided to divide into two tables. To accommodate this change, you simply 
modify the view. In other words, you don't have to modify any statements that 
refer to the view. That means that users who query the database using the view 
don't have to be aware of the change in the database structure, and application 
programs that use the view don't have to be modified. 

You can also use views to restrict access to a database. To do that, you 
include just the columns and rows you want a user or an application to have 
access to in the view. Then, you let the user or application access the data only 
through the views. For example, let's assume you have an Employees table that 
has a salary column that contains information about each employee's salary. In 
this case, you can create a view that doesn't include the salary column for the 
users who need to view and maintain this table, but who should not be able to 
view salaries. Then, you can create another view that includes the salary column 
for the users who need to view and maintain salary information. 

In addition, you can use views to hide the complexity of a SELECT state- 
ment. For example, if you have a long and unwieldy SELECT statement that 
joins multiple tables, you can create a view for that statement. This makes it 
easier for you and other database users to work with this data. 

Finally, when you create a view, you can allow data in the base table to be 
updated through the view. To do that, you use INSERT, UPDATE, or DELETE 
statements to work with the view. 
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Some of the benefits provided by views 


Design independence 
Data security 
Simplified queries 


Updatability 


Description 


> Е в 


Views can limit the exposure of tables to external users and applications. Аз а 
result, if the design of the tables changes, you can modify the view as necessary so 
the users and applications that use the view don't need to be modified. 

Views can restrict access to the data in a table by using the SELECT clause to not 
include all columns of a table or by using the WHERE clause to not include all 
rows in a table. 

Views can be used to hide the complexity of retrieval operations. Then, the data can 
be retrieved using simple SELECT statements that specify a view in the FROM 
clause. 

With certain restrictions, views can be used to update, insert, and delete data from a 
base table. 


e ‘You can create a view based on almost any SELECT statement. That means that you can 
code views that join tables, summarize data, and use subqueries and functions. 


Figure 11-2 Benefits of using views 
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How to work with views 


Now that you have a general understanding of how views work and of the 
benefits that they provide, you're ready to learn the details for working with 
them. 


How to create a view 


Figure 11-3 presents the CREATE VIEW statement that you use to create a 
view. In its simplest form, you code the CREATE VIEW keywords, followed by 
the name of the view, followed by the AS keyword and the SELECT statement 
that defines the view. In this figure, for instance, the first statement creates a 
view named vendors phone list. This view includes four columns from the 
Vendors table for all vendors with invoices. 

If you execute the first CREATE VIEW statement and a view with that 
name doesn't already exist in the current database/schema, Oracle will add the 
view, and it will display a message to indicate that the statement was successful. 
However, if a statement with this name already exists, Oracle won't add the 
view, and it will display a message that indicates that the name is already in use. 
In that case, you will need to specify a new name for the view, or you will need 
to drop the view that's already using that name. 

When you code a CREATE VIEW statement, you can specify that you want 
to automatically drop any views that have the same name as the view that you're 
creating. To do that, you can specify the OR REPLACE keywords after the 
CREATE keyword as shown in all of the examples in this figure except for the 
first. 

The SELECT statement for a view can use most of the features of a normal 
SELECT statement. In this figure, for instance, the second example creates a 
view that joins data from two tables. Similarly, the third statement creates a 
view that uses a subquery and the ROWNUM pseudo column. 

By default, the columns in a view are given the same names as the columns 
in the base tables. If a view contains a calculated column, however, you'll want 
to name that column just as you do in other SELECT statements. In addition, 
you'll need to rename columns from different tables that have the same name. 
To do that, you can code the column names in the CREATE VIEW clause as 
shown in the fourth example. Or, you can use the AS clause as shown in the 
fifth example. 

Note that you have to name all of the columns in the fourth example. In 
contrast, in the fifth example, you only have to name the columns you need to 
rename. As a result, you'll typically want to use the technique presented in the 
fifth example. 
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The syntax of the CREATE VIEW statement 


CREATE [OR REPLACE] [(FORCE|NOFORCE)] VIEW view name 
[(column alias 1[, column alias 21...)] 
AS 
Belect statement 
[WITH (READ ONLY|CHECK OPTION) [CONSTRAINT constraint name]] 


А CREATE VIEW statement that creates a view of vendors that have in- 
voices 


CREATE VIEW vendors phone list AS 
SELECT vendor name, vendor contact last name, 
vendor contact first name, vendor phone 
FROM vendors 
WHERE vendor id IN (SELECT vendor id FROM invoices) 


А CREATE VIEW statement that uses a join 


CREATE OR REPLACE VIEW vendor invoices AS 
SELECT vendor name, invoice number, invoice date, invoice total 
FROM vendors 
JOIN invoices ON vendors.vendor id s invoices.vendor id 


А CREATE VIEW statement that uses a subquery 


CREATE OR REPLACE VIEW top5 invoice totals AS 
SELECT vendor id, invoice total 
FROM (SELECT vendor id, invoice total FROM invoices 
ORDER BY invoice total DESC) 
WHERE ROWNUM <= 5 


А statement that names all the view columns in its CREATE VIEW clause 


CREATE OR REPLACE VIEW invoices outstanding 
(invoice number, invoice date, invoice total, balance dus) 
AS 
SELECT invoice number, invoice date, invoice total, 
invoice total - payment total - credit total 
FROM invoices 
WHERE invoice total - payment total - credit total > 0 


А statement that names just the calculated column in its SELECT clause 


CREATE OR REPLACE VIEW invoices outstanding AS 
SELECT invoice number, invoice date, invoice total, 
invoice total - payment total - credit total AS balance due 
FROM invoices 
WHERE invoice total - payment total - credit total > 0 


Figure 11-3 How to create a view (part 1 of 2) 
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The first example in part 2 of this figure creates a view that summarizes the 
rows in the Invoices table by vendor. This shows that a view can use aggregate 
functions and the GROUP BY clause to summarize data. In this case, the rows 
are grouped by vendor name, and a count of the invoices and the invoice total 
are calculated for each vendor. 

If you attempt to create a view for a base table that doesn't exist, Oracle will 
display an error message that indicates that the base table doesn't exist. Since 
this prevents you from creating views for tables that don't exist, this is usually 
what you want. However, if you want to create a view first and create a table 
later, you can use the FORCE option to create a view for a table that doesn't 
exist as shown in the second example in part 2 of this figure. Of course, this 
view won't display any data until a table named Products is created and the 
product. description and product price columns are filled with some data. 

When you code views, the SELECT statement you code within the defini- 
tion of a view can refer to another view. In other words, views can be nested. In 
theory, nested views can make it easier to present data to your users. In practice, 
using nested view can make the dependencies between tables and views confus- 
ing, which can make your code difficult to maintain. As a result, if you use 
nested views, you should use them carefully. 

Although this figure shows most of the skills that you'll need for creating 
views, it doesn't show how to use the WITH READ ONLY or WITH CHECK 
OPTION clauses. Instead, the next two figures show how to use those clauses. 
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A CREATE VIEW statement that summarizes invoices by vendor 


CREATE OR REPLACE VIEW invoice summary AS 
SELECT vendor name, 
COUNT(*) AS invoice count, 
SUM(invoice total) AS invoice total sum 
FROM vendors 
JOIN invoices ON vendors.vendor id = invoices.vendor id 
GROUP BY vendor name 


A CREATE VIEW statement that uses the FORCE option 


CREATE FORCE VIEW products list AS 
SELECT product description, product price 
FROM products 


Description 
e You use the CREATE VIEW statement to create a view. 
e If you include the ОК REPLACE keyword, the CREATE VIEW statement will replace 


any existing view that has the same name. Otherwise, you must specify a new name for 
the view. 

e Ifyouinclude the FORCE keyword, the CREATE VIEW statement will create the view 
even if the underlying tables don't exist. Otherwise, you must specify underlying tables 
that exist. 

e If you name the columns of a view in the CREATE VIEW clause, you have to name all 
of the columns. In contrast, if you name the columns in the SELECT clause, you can 
name just the columns you need to rename. 

e ‘You can create a view that's based on another view rather than on а table. This is known 
as a nested view. 


Figure 11-3 How to create a view (part 2 of 2) 
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How to create an updatable view 


Once you create a view, you can refer to it in a SELECT statement. In 
addition, you can refer to it in INSERT, UPDATE, and DELETE statements to 
modify the data that's stored in an underlying table. To do that, the view must be 
updatable. Figure 11-4 lists the requirements for creating updatable views. 

The first two requirements have to do with what you can code in the select 
list of the SELECT statement that defines the view. In particular, the select list 
can't include the DISTINCT clause, and it can't include aggregate functions. In 
addition, the SELECT statement can't include a GROUP BY or HAVING 
clause, and two SELECT statements can't be joined by a union operation. 

The first CREATE VIEW statement in this figure creates a view that's 
updatable. This view adheres to all of the requirements for updatable views. А$ 
a result, you can refer to it in an INSERT, UPDATE, or DELETE statement. For 
example, you can use the first UPDATE statement shown in this figure to update 
the credit total column in the Invoices base table. 

However, you can't update any calculated columns that are used by the 
view. For example, you can't use the second UPDATE statement shown in this 
figure to update the balance, due column that's calculated from the other 
columns in the view. 

In addition, when you update data through a view, you can only update the 
data in a single base table, even if the view refers to two or more tables. In this 
figure, for instance, the view includes data from two base tables, the Vendors 
and Invoices tables. However, since the first UPDATE statement only refers to 
columns in the Invoices table, it is able to update data in that table. 


How to create a read-only view 


If you don't follow the requirements for creating an updateable view, Oracle 
will automatically add the WITH READ ONLY clause to the view to create a 
read-only view. Then, you won't be able to use a view to update any columns in 
the base table. If you attempt to do this, you'll get an error message. 

If you want to make sure that a view is a read-only view, you can add the 
WITH READ ONLY clause to the CREATE VIEW statement. In this figure, for 
instance, the last example creates a read-only view. As a result, your users won't 
be able to use this view to update data in the Invoices table. 
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Requirements for creating updatable views 

e The select list can't include a DISTINCT clause. 

e The select list can’t include an aggregate function. 

e The SELECT statement can't include a GROUP BY or HAVING clause. 
e The view can’t include the UNION operator. 


А CREATE VIEW statement that creates an updatable view 


CREATE OR REPLACE VIEW balance due view AS 
SELECT vendor name, invoice number, 
invoice total, payment total, credit total, 
invoice total - payment total - credit total AS balance due 
FROM vendors JOIN invoices ON vendors.vendor id = invoices.vendor id 
WHERE invoice total - payment total - credit total > 0 


An UPDATE statement that uses the view to update data 


UPDATE balance due view 

SET credit total = 300 

WHERE invoice number s '989319-497' 
The response from the system 


l rows updated 


An UPDATE statement that attempts to use the view to update a calcu- 
lated column 


UPDATE balance due view 

SET balance due = 0 

WHERE invoice number = '989319-497'; 
The response from the system 


SQL Error: ORA-01733: virtual column not allowed here 


A CREATE VIEW statement that creates a read-only view 


CREATE OR REPLACE VIEW balance due view AS 
SELECT vendor name, invoice number, 
invoice total, payment total, credit total, 
invoice total - payment total - credit total AS balance due 
FROM vendors JOIN invoices ON vendors.vendor id = invoices.vendor id 
WHERE invoice total - payment total - credit total > 0 
WITH READ ONLY; 


Description 


e An updatable view is a view that can be used in an INSERT, UPDATE, or DELETE 
statement to update the data in the base table. 

e A read-only view is a view that cannot be used to update the data in the base table. To 
create a read-only view, you can code the WITH READ ONLY clause. 


e The requirements for coding updatable views are more restrictive than for coding read- 
only views. That's because Oracle must be able to unambiguously determine which base 
tables and columns are affected. 


Figure 11-4 Ном to create updatable and read-only views 
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How to use the WITH CHECK OPTION clause 


Figure 11-5 shows an example of an updateable view that uses the WITH 
CHECK OPTION clause to prevent an update if it causes the row to be ex- 
cluded from the view. To start, the CREATE VIEW statement creates an 
updatable view named vendor. payment that joins data from the Vendors and 
Invoices tables and displays all invoices that have a balance due that's greater 
than zero. 

Then, the first UPDATE statement uses this view to modify the 
payment date and payment. total columns for a specific invoice. This works 
because this UPDATE statement doesn't exclude the row from the view. 

However, the second UPDATE statement causes the balance due to become 
less than zero. As a result, this statement fails due to the WITH CHECK OP- 
TION clause and an error is displayed. Since this can prevent users from storing 
invalid data in a database, this clause can be useful in some situations. 


Chapter 11 Ноу to create views 


An updatable view that has a WITH CHECK OPTION clause 


CREATE OR REPLACE VIEW vendor payment AS 
SELECT vendor name, invoice number, invoice date, payment date, 
invoice total, credit total, payment total 
FROM vendors JOIN invoices ON vendors.vendor id s invoices.vendor id 
WHERE invoice total - payment total - credit total >= 0 
WITH CHECK OPTION 


A SELECT statement that displays a row from the view 


SELECT * FROM vendor payment 
WHERE invoice number - 'P-0608' 


The result set 


VENDOR, NAME INVOICE, мим... | voce рате | PevwENT pate мос тота E ereot тота |l] PavwENT TOTAL 
1 Malloy Lithographing... P-0608 11-APR-D8 (null) 2055118 1200 "E 


An UPDATE statement that updates the view 


UPDATE vendor payment 

SET payment total = 400.00, 
payment date = '01-AUG-08' 

WHERE invoice number - 'P-0608' 


The response from the system 
l rows updated 


The same row data after the update 


VENDOR, NAME [d INVOICE. NUM... F Invoice pare [@ PAYMENT DATE] mvoce тотар [i crepiT_roTat [@ PAYMENT TOTAL | 


1 Malloy Lithographing...P-O608 11-4PR-08 O1-SUG-08 20551.18 1200 400 | 


An UPDATE statement that attempts to update the view 


UPDATE vendor payment 

SET payment total s 30000.00, 
payment date = '01-AUG-08' 

WHERE invoice number = 'P-0608'; 


The response from the system 
SQL Error: ORA-01402: view WITH CHECK OPTION where-clause violation 


Description 


If you don't include а WITH CHECK OPTION clause when you create a view, a change 


you make through the view can cause the modified rows to no longer be included in the 
view. 


If you specify a WITH CHECK OPTION clause when you create a view, an error will 


occur if you try to modify a row in such a way that it would no longer be included in the 
view. 


Figure 11-5 How to use the WITH CHECK OPTION clause 
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How to insert or delete rows through a view 


In the previous figures, you learned how to use a view to update data in the 
underlying tables. Now, figure 11-6 shows how to use a view to insert or delete 
data in an underlying view. In general, this works the same as it does for a table. 
However, due to table constraints, using a view to insert or delete rows often 
results in errors like the ones shown in this figure. As a result, it's generally 
more common to work directly with base tables when inserting or deleting 
rows. 

To insert rows through a view, you can use the INSERT statement as shown 
in figure 11-6. At the top of this figure, you can see a CREATE VIEW statement 
for a view named ibm_invoices. This view retrieves columns and rows from the 
Invoices table for the vendor named IBM, which has a vendor_id of 34. Then, 
the INSERT statement attempts to insert a row into the Invoices table through 
this view. 

This insert operation fails, though, because the view and the INSERT 
statement don’t include all of the required columns for the Invoices table. In this 
case, a value is required for the other columns in the Invoices table including the 
invoice_id and invoice_due_date columns. As a result, to be able to use a view 
to insert rows, you must design a view that includes all required columns for the 
underlying table. 

In addition, an INSERT statement that uses a view can insert rows into only 
one table. That’s true even if the view is based on two or more tables and all of 
the required columns for those tables are included in the view. In that case, you 
could use a separate INSERT statement to insert rows into each table through 
the view. 

Figure 11-6 also shows how to delete rows through a view. To do that, you 
use a DELETE statement like the one shown here. To start, the first DELETE 
statement attempts to delete an invoice from the Invoices table through the 
ibm_invoices view. However, this DELETE statement fails because the invoice 
contains line items. This causes an error message like the one in this figure to be 
displayed. As a result, to get this DELETE statement to work, you must delete 
the related line items for the specified invoice before you use the ibm_invoices 
view to delete the invoice as shown by the last two DELETE statements in this 
figure. 
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А statement that creates an updatable view 


CREATE OR REPLACE VIEW ibm invoices AS 
SELECT invoice number, invoice date, invoice total 
FROM invoices 
WHERE vendor id = 34; 


The contents of the view 


INVOICE. NUMBER Г INVOICE DATE la INVOICE, TOTAL : 


1 aP5858?2 25-FEB-08 11654 
2 0545445 14-MAR-08 1083.56 


An INSERT statement that fails due to columns with null values 


INSERT INTO ibm invoices 

(invoice number, invoice date, invoice total) 
VALUES 

('RA23988', '31-JUL-08', 417.34) 
The response from the system 


SQL Error: ORA-01400: cannot insert NULL into 
("AP"."INVOICES"."INVOICE ID") 


А DELETE statement that fails due to a foreign key constraint 


DELETE FROM ibm invoices 
WHERE invoice number = 'Q545443' 


The response from the system 


SQL Error: ORA-02292: integrity constraint (AP.LINE ITEMS FK INVOICES) 
violated - child record found 


Two DELETE statements that succeed 


DELETE FROM invoice line items 
WHERE invoice id = (SELECT invoice id FROM invoices 
WHERE invoice number = !'Q545443!); 


DELETE FROM ibm invoices 
WHERE invoice number = 'Q545443'; 


The response from the system 
l rows deleted 


Description 


e You can use the INSERT statement to insert rows into a base table through a view. To do 
that, you name the view in the INSERT clause. Both the view and the INSERT statement 
must include all of the columns from the base table that require a value. 

e Ifthe view names more than one base table, an INSERT statement can insert data into 
only one of those tables. 

e You can use the DELETE statement to delete rows from a base table through a view. To 
do that, you name the view in the DELETE clause. For this to work, the view must be 
based on a single table. 


Figure 11-6 How to insert or delete rows through a view 
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How to alter or drop a view 


Although Oracle supports an ALTER VIEW statement, it's usually easier to 
alter a view by using the CREATE OR REPLACE VIEW statement to replace 
the existing view with a new one. In figure 11-7, for instance, the first example 
uses a CREATE VIEW statement to create a view named vendors, sw that 
retrieves rows from the Vendors table for vendors located in four states. Then, 
the second example uses the CREATE OR REPLACE VIEW statement to 
modify this view so it includes vendors in two additional states and is read-only. 

To drop a view, you use the DROP VIEW statement to name the view you 
want to drop. In this figure, for instance, the third example drops the view 
named vendors, sw. Like the other statements for dropping database objects, this 
statement permanently deletes the view. As a result, you should be careful when 
you use it. 
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А statement that creates a view 


CREATE VIEW vendors sw AS 

SELECT * 

FROM vendors 

WHERE vendor state IN ('CA','AZ!,'NV','NM!') 


А statement that replaces the view with a new read-only view 


CREATE OR REPLACE VIEW vendors sw AS 

SELECT * 

FROM vendors 

WHERE vendor state IN ('CA','AZ!,'NV','NM',' 'UT','CO!) 
WITH READ ONLY; 


А statement that drops the view 
DROP VIEW vendors ву 


Description 


e To alter a view, use the CREATE OR REPLACE VIEW statement to replace the existing 
view with a new one. 


e To delete a view from the database, use the DROP VIEW statement. 


Figure 11-7 Ном to alter or drop a view 
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How to use SQL Developer 


Once you understand how to write SQL code that creates and drops views, 
it's easy to learn how to use a graphical user interface such as SQL Developer to 
work with views. If you experiment with SQL Developer, I think you'll find that 
it's particularly useful for getting information about existing views. 


How to get information about a view 


Figure 11-8 shows how to use SQL Developer to get information about an 
existing view. To start, you can expand the Views folder to see a list of all views 
that are stored in a schema. In this figure, for example, the Views folder shows 
all of the views in the AP schema that were created by the SQL statements 
presented earlier in this chapter. Here, the balance due view is selected and 
displayed in the main window, and the Columns tab presents information about 
the columns of this view. 

If you want to view the data that's retrieved by a view, you can click on the 
Data tab. Then, if the view is updateable, you can use the buttons at the top of 
this tab to insert, update, and delete rows. 

If you want to get other information about a view, you can click on the 
appropriate tab. In particular, you can click on the Grants tab to see the users 
that have been granted privileges for working with the view. You can click on 
the Dependencies tab to view the tables that the view depends on. You can view 
the Details tab to get miscellaneous information about the view. And you can 
click on the SQL tab to see the SQL code that was used to create the view. 


How to drop a view 


Using SQL Developer to drop a view works the same as using SQL Devel- 
oper to drop any other type of database object. To start, right-click the view and 
select the Drop command. Then, use the resulting dialog box to confirm the 
drop. 


How to alter or create a view 


To alter the design of an existing view, you can right-click on the view and 
select the Edit command. Or, to create a new view, you can right-click on the 
Views folder and select the New View command. Then, with a little experimen- 
tation, you should be able to use the resulting dialog box to alter or create the 
view. This dialog box allows you to directly modify the SQL code, and it allows 
you to generate SQL code by selecting tables and columns from the graphical 
user interface. 
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SQL Developer with the views for the AP schema displayed 


Е Oracle SQL Deeetoper 


File Edit Yiew Navigate Run Soyrce — Migration Тоша а 
Q-5- 5. 
ева | „1 [8)яс11-01. 2 ВАГ АМСЕ DLE viEW 
& & Columns Data [Grants | Dependencies | Dstals [SaL 
л tA Connections а H бй 
Е а ар Column Name | Data Тура Nullable |Data Default | COLUMN p 10 COMMENTS il) PRIMARY KEY |) INSERT ABLE V 
F 1E) Tables "E NAME DAY L (пш) 1 (nul) (nul) NO 
Yom Te: INVOICE NUMBER VARCHAR2(50) Ма (пи) 2 (null) (nul) NO 
Bw JEMEN n INVOICE TOTAL NUMBER(B2) Ма (null 3 (null (nul) NO 
| B INVOICE NUMBER PAYMENT, TOTAL NUMBER(8,2) ‘Yee (null) 4 (null) (nul) NO 
=| INVOICE, TOTAL CREDIT, TOTAL NUMBER(S,2) ‘Yes (null) 5 (null) (nul) NO 


E PAYMENT. TOTAL BALANCE DUE NUMBER Yes (null 8 (null) (nul) NO 
E] CREDIT. TOTAL 
В BALANCE, DUE 

& Ё ВМ INVOICES 

ш ЁЎ INVOICE SUMMARY 

= ÈY INVOICES, OUTSTANDING 

= f PRODUCTS, PRICE, LIST 

m | TOPS_INVOICE_TOTALS 

m Ё VENDOR INVOICES 

= Ё VENDOR, PAYMENT 


& Bf VENDORS, PHONE JST 
m Ё VENDORS, SW 


Description 
e To examine the columns of a view, expand the Views folder and click on the view to 
display it in the main window. Then, if necessary, click on the Columns tab. 


e To work with the data for a view, click on the view to display it in the main window, and 
click on the Data tab. Then, you can view the data for the table, and you can insert, 
update, and delete rows if the view is updateable. 


e To get other information about a view, click on the view to display it in the main win- 
dow. Then, click on the Grants, Dependencies, Details, or SQL tab. 

e To drop a view, right-click on the view and select the Drop command. Then, use the 
resulting dialog box to confirm the drop. 


e To modify the design of an existing view, right-click on the view and select the Edit 
command. Then, use the resulting dialog box to modify the view. 


e To create a new view, right-click on the Views folder and select the New View command. 
Then, use the resulting dialog box to create a new view. 


Figure 11-8 | How to use SQL Developer to work with views 
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Perspective 


In this chapter, you learned how to create and use views. Аз you've seen, 
views provide a powerful and flexible way to predefine the data that can be re- 
trieved from a database. By using them, you can restrict the access to a database 
while providing a consistent and simplified way for end users and application 
programs to access that data. 


Terms 
view nested view 
base table updatable view 
viewed table read-only view 
Exercises 


1. Create a view that defines a view named open items that shows the invoices 
that haven't been paid. This view should return four columns from the Vendors 
and Invoices tables: vendor name, invoice number, invoice total, and 
balance, due (invoice total — payment, total — credit total). However, a row 
should only be returned when the balance due is greater than zero, and the rows 
should be in sequence by vendor, name. Then, run the script to create the view, 
and use SQL Developer to review the data that it returns. (You may have to 
click on the Refresh button in the Connections window after you click on the 
Views node to show the view you just created.) 


2. Write a SELECT statement that returns all of the columns in the open items 
view that you created in exercise 1, with one row for each invoice that has a 
balance due of $1000 or more. 


3. Create a view named open items summary that returns one summary row for 
each vendor that contains invoices with unpaid balance dues. Each row should 
include vendor, name, open, item count (the number of invoices with a balance 
due), and open item total (the total of the balance due amounts), and the rows 
should be sorted by the open item totals in descending sequence. Then, run the 
script to create the view, and use SQL Developer to review the data that it returns. 


4. Write a SELECT statement that returns just the first 5 rows in the 
open, items summary view that you created in exercise 3. 


5. Create an updatable view named vendor. address that returns the vendor, id, 
both address columns, and the city, state, and zip code columns for each 
vendor. Then, use SQL Developer to review the data in this view. 


6. Write an UPDATE statement that changes the address for the row with vendor 
ID 4 so the suite number (Ste 260) is stored in vendor. address2 instead of 
vendor addressl. Then, use SQL Developer to verify the change (you may 
need to click the Refresh button at the top of the Data tab to see the change). If 
this works correctly, go back to the tab for the UPDATE statement and click the 
Commit button to commit the change. 
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How to manage 
database security 


If you have installed Oracle XE on your own computer, and you have only been 
working with sample databases, security hasn't been of concern. However, 
when you use Oracle in a production environment, you must configure security 
to prevent misuse of your data. In this chapter, you'll learn how to do that by 
writing SQL statements to create users that have restricted access to your 
database. In addition, you'll learn how to use SQL Developer to perform many 
of the security-related tasks that you can perform with SQL code. 
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An introduction to database security 


Before you learn the details of coding security-related SQL statements, it's 
helpful to understand some of the general concepts for working with security. 


How to create an admin user 


Figure 12-1 begins by presenting a script that creates an administrative (or 
admin) user that has all privileges for working with the objects of a database. In 
this script, the first statement connects to the database as a user that has all 
privileges, including the capability to create users and grant privileges. In this 
case, that user is the system user that's created when Oracle is installed. If you 
don't have access to this user, you may need to consult your DBA to learn how 
to connect as a user with suitable privileges. 

After this script connects to the database, it creates a user named AR with a 
password of AR. In addition, this statement sets the default tablespace for the 
AR user to the Users tablespace. A tablespace is a container that can store users 
and other database objects such as tables and views. Typically, each tablespace 
is stored in a separate file. 

The Users tablespace is created when Oracle is installed, and it's a good 
place to store users. In this figure, for example, the code stores the AR user and 
all of its objects in the Users tablespace. Although it's possible to store users 
and their objects in the System tablespace, this is generally considered a bad 
practice since the System tablespace should be reserved for internal use by 
Oracle. 

After the script creates the AR user, it grants all privileges to this user. As a 
result, this user will be able to execute DDL statements to create tables, se- 
quences, views, and other database objects. In addition, this user will be able to 
execute DML statements such as the SELECT, INSERT, UPDATE, and DE- 
LETE statements. 

After this script grants privileges to the AR user, it connects as the AR user. 
Then, it uses the CREATE TABLE statement to create a table named Custom- 
ers. Since this statement doesn't specify a schema for the table, the table is 
stored in a schema with the same name as the user. As a result, the Customers 
table is stored in the AR schema, which is stored in the Users tablespace. А 
schema helps to group the tables in a database. 

After this script creates the Customers table, it uses three INSERT state- 
ments to insert three rows into the table. Since the script is still connected as the 
AR user, there's no need to qualify the table name with the schema name in 
these statements. However, if you were connected as another user, you would 
need to qualify the table name with the schema name like this: 

INSERT INTO ar.customers VALUES (1, 'Jack', 'Samson!); 


Finally, this figure shows how to drop a user. To do that, you can use the 
DROP USER statement. However, if the user contains tables or other database 
objects, Oracle will display an error message like the one shown in this figure, 
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А script that creates a user named AR and a table named Customers 


== connect as the SYSTEM user and create the AR user 
CONNECT system/system; 

CREATE USER ar IDENTIFIED BY ar DEFAULT TABLESPACE users; 
GRANT ALL PRIVILEGES TO ar; 


== Connect as the AR user and create the Customers table 
CONNECT аг/аг; 

CREATE TABLE customers 

( 


customer id NUMBER NOT NULL, 
customer first name VARCHAR2 (50) NOT NULL, 
customer last name VARCHAR2 (50) NOT NULL, 


CONSTRAINT customers pk 
PRIMARY KEY (customer id) 
); 
INSERT INTO customers VALUES (1, 'Jack', 'Samson'); 
INSERT INTO customers VALUES (2, 'Joan', 'Redding'); 
INSERT INTO customers VALUES (3, 'Jim', 'Abbot!); 


A statement that attempts to drop the AR user 


DROP USER ar 


The response from the system 
SQL Error: ORA-01922: CASCADE must be specified to drop 'AR' 


*Cause: Cascade is required to remove this user from the system. The 
user own's object which will need to be dropped. 
*Action: Specify cascade. 


A statement that drops the AR user and the table 


DROP USER ar CASCADE 


Description 


In a script, you can use the CONNECT command to connect to a database with the 
specified username/password. 

You can use the CREATE USER statement to create a username and password for a user. 
When you do that, it’s a good practice to specify a default tablespace for the user. A 
tablespace is a container for tables and other database objects. 

You can use the GRANT ALL PRIVILEGES statement to grant all privileges to an 
administrative (or admin) user. 

If a user connects to a database and adds a table or other database object without specify- 
ing a schema, the database object is stored in a schema with the same name as the user. 
A schema helps to group the tables in a database. 

You use the DROP USER statement to drop a user. If you use add the optional CAS- 
CADE keyword with this statement, it deletes all objects that have been created by the 
uSET. 


Figure 12-1 How to create an admin user 
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and it won't drop the user. Since this prevents you from accidentally dropping 
database objects, this is usually what you want. However, if you want to drop 
the user and all database objects stored in the user's schema, you can specify the 
CASCADE keyword as shown in the last statement. 


How to use SQL Developer to view database 
objects for a schema 


In chapter 2, you learned how to use SQL Developer to create connections 
for the AP, OM, and EX users. Then, as you progressed through this book, you 
learned how to use SQL Developer to work with these user connections. 

Now, figure 12-2 reviews this information by showing how to create a 
connection for the AR user that was created by the script presented in the 
previous figure. Once you create a connection for this user, you can use SQL 
Developer to view and work with the database objects that are stored in the 
user's schema. In this figure, for example, the AR schema is displayed in the 
Connections window, and the Tables folder is expanded to show the Customers 
table that was created by the script in figure 12-1. In addition, the main window 
shows the results for a SELECT statement that has been executed against this 
table. 
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SQL Developer with a connection for the AR user 
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How to create a connection for an admin user 


1. Right-click the Connections node in the Connections window and select the New 
Connection command to display the dialog box for creating database connections. 

2. Enter a connection name, username, and password for the connection. 

3. Click the Test button to test the connection. If the connection works, a success message 
is displayed. 

4. Click the Save button to save the connection. When you do, the connection will be 
added to the dialog box and to the Connections window. 

Description 

e Once you create an admin user, you can use SQL Developer to create a connection for 
that user. Then, you can use SQL Developer to view tables and other database objects 
that have been created by that user. 

Figure 12-2 Howto use SQL Developer to view database objects for a schema 
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How to create end users 


Figure 12-3 begins by presenting a script that creates end users that can use 
the database, but may not have all the privileges for working with the database 
objects. Here, the first statement connects to the database as the AR user. Since 
the script in figure 12-1 grants all privileges to this user, this user can create 
other users and grant them privileges. 

After the script connects as the AR user, it creates a role named ar, user. А 
role is a database object that allows you to group users. If, for example, you're 
working with a database that contains multiple users, you can use roles to group 
similar types of users. Those roles can be for developers, administrators, manag- 
ers, application users, and so on. 

After the script creates the role, it grants privileges to the role. To start, it 
grants the CREATE SESSION and CREATE PUBLIC SYNONYM privileges 
to the role named аг user. Here, the CREATE SESSION privilege allows the 
user to connect to the database, and the CREATE PUBLIC SYNONYM privi- 
lege allows the user to create a synonym that's available to all users. А synonym 
is an alias for a table, view, or other database object. Later on, this script creates 
a synonym for the Customers table that's stored in the AR schema so users can 
access that table without qualifying it with the schema name. 

After granting the CREATE SESSION and CREATE PUBLIC SYNONYM 
privileges, the script grants the SELECT and INSERT privileges on the Custom- 
ers table to the аг user role. As a result, any user that is granted the аг user role 
can select data from this table and insert rows into this table. However, this role 
doesn't let the user update or delete data in this table. 

After the script finishes granting privileges to the role, it creates three users 
in the Users tablespace, and it specifies a password of sesame for all three users. 
Then, it grants the аг user role to all three users. As a result, all three users will 
have the privileges that have been granted to the аг user role. In addition, the 
last GRANT statement grants the DELETE privilege on the Customers table to 
the user named John. 

After the script, this figure shows how to revoke privileges. This shows that 
you can use the REVOKE statement to revoke privileges from a role or a user. 
For instance, the first REVOKE statement revokes the CREATE PUBLIC 
SYNONYM privilege from the ar, user role, and the second REVOKE state- 
ment revokes the ar. user role from the user named Jim. The last REVOKE 
statement shows that you can also revoke a privilege directly from a user. This 
statement revokes the DELETE privilege on the Customers table from the user 
named John. 
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А script that creates three end users and grants them privileges 


== Gonnect as the AR user 
CONNECT ar/ar; 


-- Greate the role 
CREATE ROLE ar user; 


GRANT CREATE SESSION TO ar user; 

GRANT CREATE PUBLIC SYNONYM TO ar user; 
GRANT SELECT ON customers TO ar user; 
GRANT INSERT ON customers TO ar user; 


-- create the users 

CREATE USER john IDENTIFIED BY sesame DEFAULT TABLESPACE users; 
CREATE USER jane IDENTIFIED BY sesame DEFAULT TABLESPACE users; 
CREATE USER jim IDENTIFIED BY sesame DEFAULT TABLESPACE users; 


GRANT ar_user TO john, jane, jim; 
GRANT DELETE ON customers TO john; 
-- create the public synonym 


CONNECT john/sesame; 
CREATE PUBLIC SYNONYM customers FOR ar.customers; 


A statement that revokes privileges from a role 


REVOKE CREATE PUBLIC SYNONYM FROM ar user 


A statement that revokes a role from a user 


REVOKE ar user FROM jim 


A statement that revokes a privilege from a user 


REVOKE DELETE ON customers FROM john 


Description 


You can use the CREATE USER statement to create a user. 


You can use the CREATE ROLE statement to create a role for a user. À role is a database 
object that allows you to group users. 

You can use the CREATE PUBLIC SYNONYM statement to create a synonym that can 
be used by all users. À synonym is an alias for a table, view, or other database object. 


You can use the GRANT statement to grant privileges to a user or a role. You can also 
use this statement to grant a role to a user. 


You can use the REVOKE statement to revoke privileges from a user or a role. You can 
also use this statement to revoke a role from a user. 


For a partial list of privileges that can be granted or revoked, see figure 12-5. 


Figure 12-3 How to create end users 
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How to use SQL*Plus to test end users 


In chapter 2, you learned how to use SQL*Plus to connect to a database and 
execute SQL statements. Now, figure 12-4 reviews this information by showing how to 
use SQL*Plus to connect as an end user. This provides a quick way for you to test the 
username and password for a user, and it allows you to verify that a user has appropri- 
ate privileges. 

In this figure, for example, I began by logging in as the user named Jane. Then, I 
selected data from the Customers table to make sure that Jane can select data from this 
table. This shows that Jane has the SELECT privilege on the Customers table, and it 
shows that the script in figure 12-3 has successfully created a public synonym for the 
Customers table so that Jane doesn't need to qualify this table with the schema name. 
Finally, I used the CONNECT command to log out as Jane and to log in as John. 
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SQL*Plus after you have connected as Jane 


SGLePluc: Release 18.2.8.1.8 — Production on Tue Feb 26 16:39:53 2888 


Copyright Cc» 1982. 2885, Oracle. All rights reserved. 


Enter user-name: jane 
intel password: 


(айий ta: 
treacle Database 109 Express Edition Release 18.2.8.1.8 — Production 


SQL> select customer first name from customers; 


CUSTOMER FIRST НАМЕ 


cL? connect 
mter user-name: john 
inter password: 


Description 


e SQL*Plus is a command-line tool that’s installed with the Oracle Database. You can use 
it to work with an Oracle database. 


e To start SQL*Plus, select the Run command from the Start menu, enter “sqlplus”, and 
select the OK button. 


e To connect to a database, enter the username and password. If necessary, you can enter 
the CONNECT command to have SQL*Plus prompt you for a username and password. 


e Torun a SQL statement, you type it, type a semicolon, and press the Enter key. By 
default, you must specify the schema name for tables and other database objects. 


Figure 12-4 How to use SQL*Plus to test end users 
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System privileges and object privileges 


Figure 12-5 lists the privileges that you can code in either the GRANT or 
REVOKE statement. To start, system privileges allow the user to connect to a 
database and to create, alter, or drop database objects such as tables, sequences, 
views, and stored procedures. Although this figure doesn't show them all, 
Oracle provides system privileges for most types of DDL statements. For 
example, Oracle provides a CREATE INDEX privilege, а CREATE TRIGGER 
privilege, and so on. To see a complete list of privileges, you can look up the 
GRANT statement in the Oracle Database SQL Reference manual. 

For most privileges, you can use the ANY keyword to apply the privilege to 
any schema. For example, if you grant the CREATE TABLE privilege to a user 
named John, he can only create a table in the schema named John. However, if 
you grant the CREATE ANY TABLE privilege to John, he can create a table in 
any schema on the current server. To do that, though, John must qualify the 
name of the table with the name of the schema. 

For most CREATE privileges, there is a corresponding DROP and ALTER 
privilege. For example, Oracle provides a DROP TABLE privilege and an 
ALTER TABLE privilege. Like the CREATE TABLE privilege, you can use the 
ANY keyword to apply these privileges to any schema. Otherwise, they will 
only apply to the user's current schema. 

When you work with system privileges, granting a CREATE privilege often 
implicitly grants the corresponding ALTER and DROP privilege. In most cases, 
this works the way you want. However, if it doesn't, you can explicitly grant or 
revoke the corresponding ALTER and DROP privilege. For example, if you 
grant the CREATE TABLE privilege to a user but you don't want the user to be 
able to drop tables, you can explicitly revoke the DROP TABLE privilege. 

While system privileges allow a user to create database objects, object 
privileges allow a user to use database objects such as tables, views, sequences, 
and stored procedures after they have been created. In other words, object 
privileges allow a user to execute DML statements such as the SELECT, UP- 
DATE, INSERT, and DELETE statements. In addition, the EXECUTE privilege 
lets the user run a stored procedure or a function. For more information about 
stored procedures and functions, see chapter 15. 

When you work with object privileges, you'll find that each privilege can be 
granted only for certain types of objects. For example, you can grant a SELECT 
privilege only to an object from which you can select data, such as a table or 
view. Likewise, you can grant an EXECUTE privilege only to an object that you 
can execute, such as a stored procedure or function. 

Finally, note that the syntax for working with system privileges is a little 
different than the syntax for working with object privileges. In particular, for 
object privileges, you need to specify the ON keyword followed by the object 
that you're working with. For system privileges, though, you don't need to use 
the ON keyword to specify the object. In a moment, you'll learn more about 
how this syntax works. 
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System privileges 


CREATE SESSION Lets the user connect to the database. 


CREATE TABLE Lets the user create a table in the current schema. 

CREATE ANY TABLE Lets the user create a table in any schema. 

DROP TABLE Lets the user drop a table in the current schema. 

DROP ANY TABLE Lets the user drop a table in any schema. 

UNLIMITED TABLESPACE Lets the user create objects such as tables that need to allocate space in the 
current tablespace. 

CREATE SEQUENCE Lets the user create a sequence in the current schema. 

CREATE VIEW Lets the user create a view in the current schema. 

CREATE PROCEDURE Lets the user create a stored procedure, function, or package in the current 
Schema. 


CREATE PUBLIC SYNONYM Lets the user create a synonym in the current schema that's available to all 
users. 


Object privileges 
Privilege Description 


SELECT Lets the user select data from the specified object. This applies to tables, 
sequences, and views. 


UPDATE Lets the user update data. This applies to tables and views. 
INSERT Lets the user insert data. This applies to tables and views. 
DELETE Lets the user delete data. This applies to tables and views. 
EXECUTE Lets the user execute a stored procedure or a function. 


A statement that grants a system privilege to a role 
GRANT CREATE SESSION TO ar user 


A statement that grants an object privilege to a role 
GRANT SELECT ON customers TO ar user 


Description 


e System privileges allow the user to connect to a database and to create, alter, or drop 
database objects such as tables, views, sequences, and stored procedures. 


e Object privileges allow the user to work with database objects such as tables, views, 
sequences, and stored procedures. The privileges that are available for an object depend 
on the type of object. 


e Foracomplete list of privileges, look up the GRANT statement in the Oracle Database 
SQL Language Reference. 


Figure 12-5 System privileges and object privileges 
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How to manage database security 


Now that you have a general idea of how database security works, you're 
ready to learn the details for coding the SQL statements that create database 
users and assign privileges to them. 


How to create, alter, and drop users 


Figure 12-6 shows how to work with users. Here, the first statement shows 
how to create a user named AR with a password of AR in the tablespace named 
Users. Аз I mentioned earlier, unless a ОВА has created a tablespace for you to 
use, it's a good practice to store users in the Users tablespace. 

If you don't use the DEFAULT TABLESPACE clause to specify a 
tablespace, the user will be stored in the default tablespace for the system. 
Unfortunately, though, the default tablespace on many systems is the System 
tablespace. But as I mentioned earlier, it's a good practice to reserve this 
tablespace for database objects that are created by Oracle. 

The second statement in this figure shows how to create a user named Joel 
with a password of sesame. This statement stores this user in the Users 
tablespace, and it specifies the Temp tablespace as the temporary tablespace for 
this user. The Temp tablespace is usually created when you install Oracle, and 
it's a good practice to use this tablespace as the temporary tablespace for a user. 
However, since this tablespace is the default temporary tablespace on many 
systems, you usually don't need to specify it when you create a user. 

The QUOTA clause in the second statement lets the user allocate an unlim- 
ited amount of disk space in the Users tablespace. Then, if the user is granted 
appropriate privileges, the user will be able to create tables and other database 
objects that allocate disk space. By default, though, a user isn't allocated any 
disk space. As a result, the user can't create database objects even if that user is 
granted the privilege to create an object. 

The third and fourth statements in this figure show how to change the 
amount of disk space that's allocated to a user. Here, the third statement 
changes the amount of disk space for Joel from unlimited to 10 megabytes. 
Then, the fourth statement changes the amount of disk space for Joel to 0 bytes. 
As a result, Joel won't be able to create any more database objects. However, 
any existing objects that were created by Joel will remain. 

When you create an admin user such as the AR user as shown in figure 12-1, 
one of the privileges that's granted to the admin user is the UNLIMITED 
TABLESPACE privilege. As a result, you don't need to use the QUOTA clause 
for an admin user. However, if you wanted to prevent an admin user from 
creating any database objects, you could revoke this privilege from the admin 
user. 

Although it isn't shown in this figure, you can use the UNLIMITED key- 
word to specify an unlimited amount of disk space within an ALTER USER 
statement. Conversely, you can provide a specific number of megabytes in the 
QUOTA clause of the CREATE USER statement. 
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Three tablespaces that are created when Oracle is installed 
Tablespace Description 


SYSTEM A tablespace for storing permanent objects such tables and views that are created and 
used internally by Oracle. 


USERS А tablespace for storing users and other permanent objects such tables and views. 


TEMP А tablespace for storing temporary objects that are created when users work with a 
database. 


The syntax of the CREATE USER statement 


CREATE USER username IDENTIFIED BY password 
[DEFAULT TABLESPACE tablespace name] 

[TEMPORARY TABLESPACE tablespace name] 

[QUOTA (quota size|UNLIMITED) ON tablespace name] 


A statement that creates a user 
CREATE USER ar IDENTIFIED BY ar DEFAULT TABLESPACE users 


Another statement that creates a database user 


CREATE USER joel IDENTIFIED BY sesame 
DEFAULT TABLESPACE users 

TEMPORARY TABLESPACE temp 

QUOTA UNLIMITED ON users 


A statement that changes a user's disk space allocation quota 
ALTER USER joel QUOTA 10M ON users 


А statement that doesn't allow the user to allocate disk space 
ALTER USER joel QUOTA 0 ON users 


A statement that changes a user's password 
ALTER USER john IDENTIFIED BY secret 


A statement that forces the user to change his or her password 
ALTER USER john PASSWORD EXPIRE 


A statement that locks a users account 
ALTER USER john ACCOUNT LOCK 


А statement that unlocks a users account 
ALTER USER john ACCOUNT UNLOCK 


A statement that drops a user 
DROP USER john 


A statement that drops a user and all of its objects 
DROP USER ar CASCADE 


Figure 12-6 How to work with users 
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The fifth and sixth statements in figure 12-6 show how to work with a user's 
password. Here, the fifth statement changes the password for John to secret. 
Then, the sixth statement causes the password for John to expire. As a result, the 
next time a user logs in as John, he or she will have to enter the old password 
and create a new password. 

The seventh and eighth statements show how to lock or unlock a user's 
account. If, for example, you want to temporarily lock John out of the database, 
you can use the seventh statement. Or, if a user enters an invalid password more 
than three times in a row, the user's account may become locked so you need to 
unlock it. 

The last two statements show how to drop a user. If the user hasn't created 
any objects, you can use the DROP statement without the CASCADE keyword. 
But if the user has created objects, you must add the CASCADE keyword to 
drop the user. Then, Oracle will delete the user and all of the objects that are 
stored in the schema for the user. In other words, the last statement will delete 
the entire AR schema! So please be careful when you use this statement. 


As you learned earlier in this chapter, you can use a role to make it easier to 
work with users. To do that, you use the CREATE ROLE statement that's shown 
in figure 12-7. Here, the second CREATE ROLE statement uses the IDENTI- 
FIED BY clause to supply a password for a role. Although you can use this 
clause to provide an additional level of security, passwords are rarely assigned 
to roles. Instead, they are typically assigned to users as shown in the previous 
figure. 

Once you've created a role, you can grant privileges to it, and you can grant 
the role to a user. You'll learn how to do that next. Later, if you want to drop a 
role, you can use the DROP ROLE statement shown in this figure. 
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А statement that creates a role 
CREATE ROLE ap user 


Another statement that creates a role 
CREATE ROLE ap admin IDENTIFIED BY secret 


A statement that drops a role 
DROP ROLE ap user 


Another statement that drops a role 
DROP ROLE ap admin 
Description 


e ‘You use the CREATE ROLE statement to create roles. Although you can use the IDEN- 
TIFIED BY clause to specify a password for a role, this clause is rarely used. 


e You use the DROP ROLE statement to drop roles. 


Figure 12-7 How to work with roles 
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How to grant privileges 


Figure 12-8 shows how to use the GRANT statement to grant system and 
object privileges to a role or a user. To start, the first two statements show how 
to grant system privileges. Here, the first statement grants the CREATE SES- 
SION privilege to the role named ap, user. Then, the second statement grants the 
same privilege to the role named ap, developer. However, since this statement 
includes the WITH ADMIN OPTION clause, any user in the ap. developer role 
can grant the specified privilege to other users. 

The third and fourth statements show how to grant object privileges. Here, 
the third statement grants the SELECT privilege on the Vendors table to the 
ap. user role, and the fourth statement grants the same privilege to the role 
named ap, manager. However, since this fourth statement includes the WITH 
GRANT OPTION clause, any user in the ap, manager role can grant the speci- 
fied privilege to other users. 

The fifth statement shows that you can grant multiple privileges by separat- 
ing the privileges with commas. This statement grants the SELECT, INSERT, 
UPDATE, and DELETE privileges on the Vendors table to the ар user role. 
Although it isn't shown, you can use a similar technique for granting multiple 
system privileges. You can also grant privileges to multiple roles and users by 
separating them with commas. 

The sixth statement shows how to use the ALL keyword to grant most of the 
privileges for the specified database object. This statement grants all privileges 
on the Vendors table to the ap, user role, which grants all of the privileges that 
are granted by the fifth example: SELECT, INSERT, UPDATE, and DELETE. 
In addition, this statement grants several other privileges such as FLASHBACK 
and DEBUG. The advantage of using the ALL keyword is that you write less 
code to grant all privileges on an object. The disadvantage is that you may 
accidentally grant a user more privileges than the user needs, which could open 
a hole in the security of your database. 

Before you can grant privileges, you must connect as an appropriate user. In 
this figure, for instance, the examples assume that you are connected as the AP 
user for two reasons. First, this user has the necessary privileges to grant all 
system and object privileges to other roles and users. Second, the database 
objects shown in this figure are stored in the schema for this user. As a result, 
you don't need to qualify the names of these objects with the schema name. In 
this figure, that means that you don't need to qualify the Vendors and Invoices 
tables with the AP schema. However, if you weren't connected as the AP user, 
you would need to qualify these object names with the schema name. 

Finally, note that you can grant privileges to specific columns for an object 
that has columns, such as a table. However, it's usually easier to create a view 
that provides access to the columns that you want to grant to the user. Then, you 
can grant privileges on the view but not on the table. 
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The syntax of the GRANT statement for system privileges 


GRANT system privilege[, ...] 
TO user or role [, ...] 
[WITH ADMIN OPTION] 


The syntax of the GRANT statement for object privileges 


GRANT object privilege[, ...] 

ON [schema name.]object name [(column [, ...])] 
TO user or role [, ...] 

[WITH GRANT OPTION] 


А statement that grants a system privilege to a role 
GRANT CREATE SESSION TO ap user 


А statement that grants a system privilege with the admin option 
GRANT CREATE SESSION TO ap developer WITH ADMIN OPTION 


A statement that grants an object privilege to a role 
GRANT SELECT ON vendors TO ap user 


A statement that grants an object privilege to a role with the grant option 
GRANT SELECT ON vendors TO ap manager WITH GRANT OPTION 


А statement that grants all object privileges for a table to a role 
GRANT SELECT, INSERT, UPDATE, DELETE ON invoices TO ap user; 


Another way to grant all object privileges for a table to a role 
GRANT ALL ON invoices TO ap user; 


А statement that grants a role to multiple users 
GRANT ap user TO john, jane; 


А statement that grants a role to another role 
GRANT ap user TO ap developer; 


Description 
e You use the GRANT statement to grant system or object privileges to users or roles. 
e For a partial list of system and object privileges, refer back to figure 12-5. 


e The WITH ADMIN OPTION clause allows the user or role to grant the specified system 
privileges to other users or roles. 


e The WITH GRANT OPTION clause allows the user or role to grant the specified object 
privileges to other users or roles. 


Figure 12-8 How to grant privileges 


385 


386 


Section 3 Database design and implementation 


How to revoke privileges 


Figure 12-9 shows how to use the REVOKE statement to revoke system or 
object privileges. Аз you can see, this statement is similar to the GRANT 
statement, but it reverses the action of a GRANT statement. 

To start, the first REVOKE statement in this figure shows how to revoke a 
system privilege. This statement revokes the DROP ANY VIEW privilege from 
the user role named ap developer. 

In contrast, the second statement shows how to revoke an object privilege. 
This statement revokes the SELECT privilege on the Invoices table from the 
ap. user role. 

The third statement shows that you can revoke multiple object privileges by 
separating each privilege with a comma. This statement revokes the INSERT, 
UPDATE, and DELETE privileges on the Invoices table from the ap. user role. 

The fourth statement shows how to use the ALL keyword to revoke all 
privileges on a database object. This works similarly to the previous two state- 
ments. However, it also revokes any other privileges that may have been granted 
on the Invoices table from the ap. user role. If you need to make sure that you've 
revoked all privileges on an object, this is the way to do it. 

The fifth statement shows how to revoke a role from multiple users. In 
particular, it revokes the ap users role from the users named John and Jane. 

The sixth statement shows how to revoke one role from another role. 
Specifically, it revokes the ap users role from the ар developer role. Аз a result, 
the ap. developer role will no longer have the privileges that have been granted 
to the ар user role. 
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The syntax of the REVOKE statement for system privileges 


REVOKE system privilege [, ...] 
FROM user or role [, ...] 


The syntax of the REVOKE statement for object privileges 


REVOKE object privilege 
ON [schema name.]object name [(column [, ...])] 
FROM user or role [, ...] 


А statement that revokes a system privilege from a role 
REVOKE DROP ANY VIEW FROM ap developer; 


А statement that revokes an object privilege from a role 
REVOKE SELECT ON invoices FROM ap user; 


А statement that revokes multiple object privileges from a role 
REVOKE INSERT, UPDATE, DELETE ON invoices FROM ap user 


А statement that revokes all object privileges from a role 
REVOKE ALL ON invoices FROM ap user 


А statement that revokes a role from multiple users 
REVOKE ap user FROM john, jane 


А statement that revokes a role from another role 
REVOKE ap user FROM ap developer 


Description 
e ‘You can use the REVOKE statement to revoke privileges from a user or role. 
e Fora partial list of privileges that can be revoked, see figure 12-5. 


Figure 12-9 Ном to revoke privileges 
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How to work with private synonyms 


Earlier in this chapter, you learned that a synonym is an alias for a table, 
view, or other database object. Now, figure 12-10 shows how to work with a 
private synonym, which is a synonym that's only available to the current user. 

The primary benefit of using a synonym is that it allows applications to 
work without modification regardless of which schema a table or view is stored 
in. To illustrate, the first example in this figure shows what happens when a user 
named John tries to use the Vendors table in the AP schema without qualifying 
the table name. In this case, an error message is displayed and the statement 
fails. 

To solve this problem, you can create a synonym for a user as shown by the 
second and third examples. To start, you need to connect as an admin user and 
grant the CREATE SYNONYM privilege to the user. Then, you can connect as 
the user named John and use the CREATE SYNONYM statement to create a 
synonym for the ap.vendors table. 

At this point, John can use the same code as the AP user to refer to the 
Vendors table as shown in the fourth example. In other words, any statements 
that work on the Vendors table for the AP user will now work for John without 
any modification. This assumes, however, that John has all necessary privileges 
for working with the Vendors table. For example, to select data from this table, 
John must have the SELECT privilege on the Vendors table. 

The last statement in this figure shows how to drop a synonym. Since this 
works like most other DROP statements described in this book, you shouldn't 
have any trouble using it. 
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А SELECT statement that fails because it doesn't specify the schema 
name for the table 


CONNECT john/sesame; 
SELECT vendor name FROM vendors WHERE vendor id - 1; 


The error message that's displayed 
SQL Error: ORA-00942: table or view does not exist 


How to grant the CREATE SYNONYM privilege 


CONNECT ap/ap; 
GRANT CREATE SYNONYM TO john; 


How to create a synonym for a single user 


CONNECT john/sesame; 
CREATE SYNONYM vendors FOR ap.vendors; 


А SELECT statement that succeeds due to the synonym 
SELECT vendor name FROM vendors WHERE vendor id - 1 
The result set 
VENDOR, NAME | 


1 US Postal Service - 


How to drop a synonym 
DROP SYNONYM vendors 


Description 
e Aprivate synonym is a synonym that's only available to the current user. 


e Synonyms allow applications to work without modification regardless of which user 
owns the table or view. 


e Ifa user has the CREATE SYNONYM privilege, the user can use the CREATE SYN- 
ONYM statement to create a private synonym. 


e Before a user can use a synonym, the user must have appropriate privileges on the 
underlying object. 


Figure 12-10 How to work with private synonyms 
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How to work with public synonyms 


If you only need to create a synonym for a single user, you can use a private 
synonym as described in the previous figure. However, for multi-user databases, 
you often need to create a synonym for all users in the database. In that case, 
you can use a public synonym as described in figure 12-11. 

Once you understand how to work with private synonyms, you shouldn't 
have any trouble working with public synonyms. The main difference is that 
you use the PUBLIC keyword before the SYNONYM keyword. In this figure, 
for instance, the third statement uses the CREATE PUBLIC SYNONYM 
statement to create a public synonym. Similarly, the last statement uses the 
DROP PUBLIC SYNONYM statement to drop a public synonym. 

In this figure, please note that the third example creates a public synonym 
for the user named John. However, this allows the user named Jane to access the 
Vendors table without specifying the schema name as shown by the fourth 
example. This shows that a public synonym is available to all users, not just to 
John. 
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А SELECT statement that fails because it doesn't specify the schema 
name for the table 


CONNECT john/sesame; 
SELECT vendor name FROM vendors WHERE vendor id - 1; 


The error message that's displayed 
SQL Error: ORA-00942: table or view does not exist 


How to grant the CREATE PUBLIC SYNONYM privilege 


CONNECT ap/ap; 
GRANT CREATE PUBLIC SYNONYM TO ap user; 


How to create a synonym for all users 


CONNECT john/sesame; 
CREATE PUBLIC SYNONYM vendors FOR ap.vendors; 


А SELECT statement that succeeds due to the public synonym 


CONNECT jane/sesame; 
SELECT vendor name FROM vendors WHERE vendor id = 1 


The result set 


VENDOR. МАМЕ 
1 US Postal Service = 


How їо drop a synonym 
DROP PUBLIC SYNONYM vendors 


Description 
e А public synonym is a synonym that's available to all users. 


e Ifa user has the CREATE PUBLIC SYNONYM privilege, the user can use the CREATE 
PUBLIC SYNONYM statement to create a public synonym that's available to all users. 


Figure 12-11 How to work with public synonyms 
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А script that creates roles and users 


Figure 12-12 shows a script that creates roles and users that can work with 
the tables and other database objects in the AP schema. To start, this script 
connects as the AP user, which has appropriate privileges for creating roles, 
creating users, and granting privileges. Then, it uses an anonymous PL/SQL 
script to drop any existing users, roles, or synonyms that are created by the 
script. Note that the DROP USER statement for Joel includes the CASCADE 
keyword so it drops any database objects that exist within the schema named 
Joel. 

After the script drops any existing objects, it creates three roles: ар user, 
ap. manager, and ap, developer. Then, the script grants privileges to these three 
roles. 

The ap. user role has the fewest privileges. It can connect to the database 
and create a public synonym. It can select and modify data in the Vendors, 
Invoices, and Invoice Line Items tables. It can select data from the Terms and 
General Ledger Accounts tables. And it can use the sequences for the Vendors 
and Invoices tables. In short, this role has all of the privileges needed for a user 
to work with an Accounts Payable application. 

The ap. manager role has all of the privileges of the ap user role, and it has 
а few more privileges. In particular, it can grant the ар user role to other users, 
and it can modify data in the Terms and General Ledger Accounts tables. In 
short, this role has all of the privileges needed for a manager to perform mana- 
gerial functions with an Accounts Payable application. 


GRANT 
GRANT 
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А script that sets up the roles and users for a database Page 1 
CONNECT ар/ар: 
-- Use an anonymous PL/SQL script to 
-- drop all end users, roles, and synonyms in the current database 
-- and suppress any error messages that may be displayed 
== if these objects don't exist 
BEGIN 
EXECUTE IMMEDIATE 'DROP USER john'; 
EXECUTE IMMEDIATE 'DROP USER јапе!; 
EXECUTE IMMEDIATE 'DROP USER jim'; 
EXECUTE IMMEDIATE 'DROP USER joel CASCADE'; 
EXECUTE IMMEDIATE 'DROP ROLE ap user!; 
EXECUTE IMMEDIATE 'DROP ROLE ap manager!; 
EXECUTE IMMEDIATE 'DROP ROLE ap developer!; 
EXECUTE IMMEDIATE 'DROP PUBLIC SYNONYM vendors'; 
EXECUTE IMMEDIATE 'DROP PUBLIC SYNONYM invoices'; 
EXECUTE IMMEDIATE 'DROP PUBLIC SYNONYM invoice line items'; 
EXECUTE IMMEDIATE 'DROP PUBLIC SYNONYM general ledger accounts’; 
EXECUTE IMMEDIATE 'DROP PUBLIC SYNONYM terms!; 
EXCEPTION 
WHEN OTHERS THEN 
DBMS OUTPUT.PUT LINE('!); 
END; 
/ 
-- create the roles 
CREATE ROLE ap user; 
CREATE ROLE ap manager; 
CREATE ROLE ap developer; 
=-=- grant privileges to the ap user role 
GRANT CREATE SESSION TO ap user; 
GRANT CREATE PUBLIC SYNONYM TO ap user; 
GRANT ALL ON vendors TO ap user; 
GRANT SELECT, INSERT, UPDATE, DELETE ON invoices TO ap user; 
GRANT SELECT, INSERT, UPDATE, DELETE ON invoice line items TO ap user; 
GRANT SELECT ON general ledger accounts TO ap user; 
GRANT SELECT ON terms TO ap user; 


SELECT ON invoice id seq TO ap user; 
SELECT ON vendor id seq TO ap user; 


-- grant privileges to the ap manager role 

GRANT ap user TO ap manager WITH ADMIN OPTION; 
GRANT ALL ON general ledger accounts TO ap manager; 
GRANT ALL ON terms TO ap manager; 


Figure 12-12 A script that creates the roles and users for a database (part 1 of 2) 
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The ар developer role has all of the privileges of the ap manager role, and 
it has a few more privileges. In particular, it can create and drop tables, views, 
and sequences from any schema in the database. Although this role doesn't have 
all the privileges that are available to the AP user, it has all enough privileges for 
a developer to work with the tables, views, and sequences of the Accounts 
Payable application. 

After this script grants privileges to the roles, it creates some users. In 
particular, it creates four users named John, Jane, Jim, and Joel. It creates a 
password of sesame for all of them. And it sets the Users tablespace as the 
default tablespace for these users. As a result, these users and any objects that 
they create will be stored in the Users tablespace. 

After this script creates the users, it assigns them to their roles. Here, John 
and Jane are assigned to the ap user role, Jim is assigned to the ap manager 
role, and Joel is assigned to the ар developer role. This shows that multiple 
users can be assigned to a role. 

To keep this script easy to understand, it only creates four users. However, 
for a real-world application, you might need to create hundreds of users. To do 
that, you might want to use PL/SQL to write code that queries an existing 
database of users, creates the users, and assigns them to the appropriate role. To 
learn more about PL/SQL, see chapter 13. 

After this script assigns roles for the users, it alters the user named Joel so 
he can allocate up to 10MB of disk space in the Users tablespace. Without this 
statement, Joel would not be able to create tables or views or other objects that 
allocate disk space even though the ap. developer role was granted the CREATE 
ANY TABLE and CREATE ANY VIEW privileges earlier in the script. 

By contrast, the AP user has the UNLIMITED TABLESPACE privilege. As 
a result, there is no limit to the amount of disk space that the AP user can 
allocate. 

After this script sets the disk space quota for Joel, it connects to the data- 
base as Joel and creates public synonyms for the tables in the AP schema. Since 
these synonyms are public, they are also available to John, Jane, Jim, and any 
other users that are created later. 

Finally, this script connects as the AP user, and alters the password for each 
user so it is expired. This forces each user to change his or her password when 
he or she connects to the database for the first time. To start, the user needs to 
specify the sesame password that's created earlier in the script. Then, the user 
can create a new password. This secures the database by forcing users to 
generate their own unique passwords that are different than the one that's stored 
in the script. 
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A script that sets up the roles and users for a database Page 2 


-- grant privileges to the ap developer role 
GRANT 

ap manager, 

CREATE ANY TABLE, 

DROP ANY TABLE, 

CREATE ANY VIEW, 

DROP ANY VIEW, 

CREATE ANY SEQUENCE, 

DROP ANY SEQUENCE 
TO ap developer; 


-- create the users 

CREATE USER john IDENTIFIED BY sesame DEFAULT TABLESPACE users; 
CREATE USER jane IDENTIFIED BY sesame DEFAULT TABLESPACE users; 
CREATE USER jim IDENTIFIED BY sesame DEFAULT TABLESPACE users; 
CREATE USER joel IDENTIFIED BY sesame DEFAULT TABLESPACE users; 


-- assign the users to their roles 
GRANT ap_user TO john, jane; 

GRANT ap manager TO jim; 

GRANT ap developer TO joel; 


-- allow joel to create tables 
ALTER USER joel QUOTA 10M ON users; 


-- create synonyms for all users 

CONNECT jcel/sesame; 

CREATE PUBLIC SYNONYM vendors FOR ap.vendors; 

CREATE PUBLIC SYNONYM invoices FOR ap.invoices; 

CREATE PUBLIC SYNONYM invoice line items FOR ap.invoice line items; 

CREATE PUBLIC SYNONYM general ledger accounts FOR 
ap.general ledger accounts; 

CREATE PUBLIC SYNONYM terms FOR ap.terms; 


-- require the users to change their passwords when they log in 
CONNECT ap/ap; 

ALTER USER john PASSWORD EXPIRE; 

ALTER USER jane PASSWORD EXPIRE; 

ALTER USER jim PASSWORD EXPIRE; 

ALTER USER joel PASSWORD EXPIRE; 


Description 


e When you create a database, you can use a script to create the users and roles and assign 
privileges to them. 


Figure 12-12 A script that creates the roles and users for a database (part 2 of 2) 
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How to view the privileges for users and roles 


Figure 12-13 shows how you can use SELECT statements to view the 
privileges that have been granted to a user. In the first example, the user con- 
nects as the AP user and grants one system privilege and one object privilege 
directly to the user named John. That way, the second and third examples return 
one row each when you view the privileges for John. Otherwise, these two 
examples wouldn't return any rows. 

Since the rest of the statements in this figure work with the current user, you 
start by connecting to the database as the user whose privileges you want to 
view. So after the first example, I connected to the database as John. As a result, 
John is the user for all of the other examples in this figure. 

The second example shows how to view the system privileges for the 
current user. As a result, this statement returns all of the privileges that have 
been granted to John. In this case, the only system privilege that has been 
granted directly to John is the CREATE PROCEDURE privilege that was 
granted by the first example. 

The third example shows how to view the object privileges for the current 
user. Like the previous statement, this statement returns a single privilege that 
was granted directly to John by the first example. 

The fourth example shows how to view the role privileges for the current 
user. This statement shows that John is a member of the ap user role. 

The fifth example shows how to view the system privileges that are granted 
to John through the roles. In this case, that shows all of the system privileges 
that are granted to John through his only role, the ap user role. These system 
privileges include the two that were granted by the script in the previous figure: 
the CREATE SESSION and CREATE PUBLIC SYNONYM privileges. 

If John had been assigned multiple roles, the result set would include all of 
the system privileges from each role. In that case, if you wanted to narrow the 
result set to a single role, you could include a WHERE clause like this: 

SELECT * FROM role Sys privs WHERE role s 'AP USER' 


For this to work, though, you must use all caps when coding the name of the 
role. Otherwise, Oracle won't return any data. 

The sixth example works like the fourth one, but it displays all object 
privileges that are granted to John though his roles. Here, the result set shows 
the first four rows of the 16 object privileges that were granted by the script 
shown in the previous figure. 
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Some code that grants system and object privileges directly to a user 


CONNECT ap/ap; 
GRANT CREATE PROCEDURE TO john; 
GRANT SELECT ON vendors TO john; 


А SELECT statement that views system privileges for the current user 
SELECT * FROM user Sys privs 


The result set 


USERNAME | PRIVILEGE ADMIN, OPTION 


CREATE PROCEDURE 


А SELECT statement that views object privileges for the current user 
SELECT * FROM user tab privs 


The result set 


GRANTEE |l] owner | TABLE маме | cRANTOR | PRIVILEGE GRANTABLE | HIERARCHY 


VENDORS SELECT 


А SELECT statement that views role privileges for the current user 
SELECT * FROM user role privs 


The result set 


USERNAME |l] GRANTED_ROLE |l Армм ортом Ш DEFAULT_ROLE |l] os_cRANTED 
1 JOHN AP USER NO YES NO 


А SELECT statement that views all system privileges for the ap user role 
SELECT * FROM role Sys privs 


The result set 


ROLE П PRIVILEGE ll] дрмм OPTION 
1 AP_USER CREATE PUBLIC SYNONYM NO > 
2 AP, USER CREATE SESSION NO 


A SELECT statement that views all object privileges for the ap user role 
SELECT * FROM role tab privs 


The result set 


ROLE | owner |  ТАБПЕ МАМЕ [] coLuwN маме 0 PRIVILEGE GRANTABLE 
1 AP_USER AP INVOICES (null) INSERT NO a 
2 AP_USER АР INVOICES (null) UPDATE NO E 
3 AP USER АР INVOICES (null) SELECT NO { 
4 АР USER. АР INVOICE LINE ITEMS (null UPDATE NO Е 


Figure 12-13 Ном to view the privileges for users and roles 
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How to use SQL Developer 


Since you often use a script to set up the security for a database or to view 
the privileges that have been granted to a user, it's important to understand the 
SQL statements presented in this chapter. Once you understand Шеш, it's easy 
to learn how to use a graphical user interface such as SQL Developer to work 
with security. For example, it's easy to use SQL Developer to drop or alter an 
existing user or to grant or revoke the privileges for a user. 


How to work with users 


Figure 12-14 shows how to use SQL Developer to work with users. To start, 
you can view the users for a database by expanding the Other Users folder for 
any connection in the Connections window. 

However, before you can use SQL Developer to work with users, you need 
to create a connection for the system user as described in figure 12-2. Other- 
wise, you won't have appropriate privileges, and the options in the dialog boxes 
will be grayed out. In this figure, for example, note that a connection named 
system is displayed at the top of the Connections window. This is the connec- 
tion for the system user. 

If you want to drop a user, you can right-click on the user and select the 
Drop User command. Then, you can use the resulting dialog box to confirm the 
drop. 

If you want to edit a user, you can right-click on the user, select the Edit 
User command, and click on the User tab in the resulting dialog box. In this 
figure, for example, you can see the dialog box for the user named John. Note 
here that the default tablespace for John is the Users tablespace and that the 
temporary tablespace is the Temp tablespace. Most of the time, this is what you 
want. But if it isn't, you can use this dialog box to select new tablespaces for 
John. 

At this point, you can create a new password for John by entering and 
confirming the password and clicking on the Apply button. You can force John 
to change his password the next time he logs in by checking the Password 
Expired check box. Or, you can lock or unlock John's account by checking or 
unchecking the Account Is Locked check box. 
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Description 


e To display the users for a database, you can use SQL Developer to connect to the data- 
base. Then, you can expand the Other Users folder to see all users. 


e To work with a user, you must connect as the system user. To do that, you can create а 
new connection as described in figure 12-2. 


e To drop a user, right-click on the user and select the Drop User command. Then, use the 
resulting dialog box to confirm the drop. 


e To edit a user, right-click on the user, select the Edit User command, and click on the 
User tab in the resulting dialog box. Then, you can (1) set the password, (2) force the 
user to change the password on the next login, (3) lock or unlock the users account, or 
(4) change the tablespace settings for the user. 


Figure 12-14 How to use SQL Developer to work with users 
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How to grant and revoke roles 


Figure 12-15 shows how to use SQL Developer to grant or revoke roles. 
Here, you can see the Roles tab of the dialog box that was displayed in the 
previous figure. This tab shows that the user named John has only been granted 
one role, the ap user role. At this point, you can grant additional roles by 
checking the Granted column; you can allow the user to grant the role to other 
users by checking the Admin column; and you make a role available to a user 
by default when the user connects to the database by checking the Default 
column. 

Most of the time, you want a role to be available to the user by default when 
the user connects to the database. As a result, if you check the Granted column 
for a role, you'll typically want to check the Default column too. However, if 
you want to introduce an additional level of security for roles, you can deselect 
the Default column for the user. Then, when the user logs on, the role won't be 
available to the user by default. Instead, the user will have to issue a SET ROLE 
statement that identifies the role and specifies a password for it before the user 
will be granted the privileges associated with that role. 

Conversely, you can reverse these settings by removing the check mark 
from the appropriate columns. For example, you can revoke the ap. user role 
from John by removing the check marks from the Granted and Default columns 
for this role. 

Finally, note that this dialog box displays many system roles that are 
automatically available from Oracle. Although some of these roles such as the 
CONNECT and RESOURCE roles may be useful in some situations, they may 
change if you upgrade to a new version of Oracle. As a result, I don't recom- 
mend using them, especially since it's fairly easy to create your own roles that 
provide the privileges that are necessary for your applications. 
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Granted Default 


DELETE, CATALOG, ROLE 
EXECUTE CATALOG. ROLE 
EXP. FULL DATABASE 
GATHER, SYSTEM, STATISTICS 
HS, ADMIN, ROLE 

IMP. FULL DATABASE 
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Description 


e To work with the roles that are assigned to a user, right-click on the user, select the Edit 
User command, and click on the Roles tab in the resulting dialog box. 


e You can use the Roles tab of the User Dialog box to (1) view the roles that are assigned 
to the user, (2) grant or revoke a role, (3) grant or revoke the admin option for the role, or 
(4) control whether the user has access to the role by default after connecting to the 
database. 


Figure 12-15 How to use SQL Developer to work with roles 
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How to grant and revoke system privileges 


Figure 12-16 shows how to use SQL Developer to grant or revoke system 
privileges. Here, you can see the System Privileges tab of the dialog box that 
was displayed in figure 12-14. This tab shows that the user named John has only 
been granted one system privilege, the CREATE PROCEDURE privilege. At 
this point, you can grant additional system privileges by checking the Granted 
column, or you can allow the user to grant system privileges to other users by 
checking the Admin Option column. 

Conversely, you can reverse these settings by removing the check mark 
from the appropriate column. For example, you can revoke the CREATE 
PROCEDURE role from John by removing the check mark from the Granted 
column for this role. 

Finally, note that this dialog box displays a list of all system privileges. If 
you compare these system privileges with the system privileges that are shown 
in figure 12-5, you can see that figure 12-5 only presents a small subset of these 
privileges. 
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The dialog box for working with system privileges 


f^ User Dialog 


User [Roles System Privilages Quotes |S@L |Resuts 


Privilege oe Granted Admin Option 


CREATE DATABASE LINK 
CREATE DIMENSION 

CREATE EVALUATION CONTEXT 
CREATE EXTERNAL JOB 
CREATE INDEXTYPE 

CREATE JOB 

CREATE LIBRARY 

CREATE MATERIALIZED VIEVY 
CREATE OPERATOR 

CREATE PROCEDURE 

CREATE PROFILE 

CREATE PUBLIC DATABASE LINK 
CREATE PUBLIC SYNONYM 
CREATE ROLE 

CREATE ROLLBACK SEGMENT 
CREATE RULE 

CREATE RULE SET 

CREATE SEQUENCE 

CREATE SESSION 


кеа 
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Description 


e To work with the system privileges that are assigned to a user, right-click on the user, 
select the Edit User command, and click on the System Privileges tab in the resulting 
dialog box. 

e You can use the System Privileges tab in the User Dialog box to (1) view the system 
privileges that are assigned to the user, (2) grant or revoke a system privilege, or (3) 
grant or revoke the admin option for the system privilege. 


Figure 12-16 How to use SQL Developer to work with system privileges 


404 Section 3 Database design and implementation 


Perspective 


Although managing security can be complex, Oracle provides useful tools to 
simplify the job. In this chapter, you learned how to manage security by writing 
SQL statements, and you learned how to use SQL Developer to work with users 
and roles. Once you're familiar with both of these techniques, you can use the one 
that's easiest for the security task at hand. 

Although SQL Developer makes it easy to work with security, it can also slow 
you down. For example, if you're working with a database that has hundreds of 
users for an application, you'll probably need to use SQL statements and PL/SQL 
scripts to help you manage these users. Since many scripts for performing com- 
mon security-related tasks are available from the Internet, you may be able to 
download a script that does what you want. Otherwise, you can use the skills that 
you'll learn in the next chapter to write your own script. 


Terms 


tablespace 
schema 

role 

synonym 
system privilege 
object privilege 
private synonym 
public synonym 
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Exercises 


1. 


Write a script that creates a database role named payment entry in the АР 
schema. This new role should have SELECT and UPDATE privileges for the 
Vendors table; SELECT and UPDATE privileges for the Invoices table; and 
SELECT, UPDATE, and INSERT privileges for the Invoice Line, Items table. 
This role should also have the right to create a session. 


Write a script that creates a user named Tom with a password of "temp" and 
assigns the payment, entry role to him. Next, use SQL*Plus to test whether the 
username and password are able to connect to the database. Then, use SQL*Plus 
to run a SELECT statement that selects the vendor. id column from all rows in 
the Vendors table. 


Use SQL Developer to test whether the user and role that you created in 
exercises 1 and 2 work correctly. To start, create a new connection for the used 
named Tom. Then, write a SELECT statement to select all of the columns for all 
of the rows in the Vendors table, and use the Tom connection to run it. (It should 
succeed, though you may need to qualify the table name with the schema name.) 
Finally, write a DELETE statement that attempts to delete one of the rows in the 
Vendors table, and use the Tom connection to run it. (It should fail due to 
insufficient privileges.) 


Run SELECT statements like those in figure 12-13 to view the user and role 
privileges that are available to Tom. 


Write a script that grants the privilege of creating public synonyms to the 
payment, entry user. Then, use the AP connection to execute this script. 


Write a script that creates public synonyms for each of the tables used by the 
payment, entry user. Then, use the Tom connection to execute this script. Finally, 
write and run some SELECT statements that test whether these public synonyms 
Work correctly. 
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Section 4 


The essential PL/SQL skills 


This section presents the essential skills for using Oracle's procedure language, 
which is called PL/SQL. These are the skills that will take your SQL capabilities 
to the next level. 

In chapter 13, you'll learn the basics of PL/SQL coding. In chapter 14, you'll 
learn how to use PL/SQL to help manage transactions and locking. In chapter 15, 
you'll learn how to use PL/SQL to create stored procedures and functions. And 
in chapter 16, you'll learn how to use PL/SQL to create triggers. 
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How to write PL/SQL code 


In chapter 12, you saw a simple script that created a user and a table within that 
user's schema. Now, this chapter shows you how to code more complex scripts 
that include blocks of PL/SQL (Procedural Language/SQL) code. With the 
skills you'll learn in this chapter, you'll be able to code scripts that provide 
functionality similar to procedural programming languages like Java, C++, C#, 
and Visual Basic. 

If you have experience with another procedural language, you shouldn’t 
have any trouble with the skills presented in this chapter. However, you 
should know that the programming power of PL/SQL is limited when com- 
pared to other languages. That’s because PL/SQL is designed specifically to 
work with Oracle databases rather than as a general-purpose programming 
language. For its intended use, however, PL/SQL is both powerful and 


flexible. 
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An introduction to PL/SQL 


Before you learn the details for writing PL/SQL code, it's helpful to get an 
overview by looking at a block of PL/SQL code that's included within a script. In 
addition, it's helpful to preview the statements that are commonly used within 
scripts and within blocks of PL/SQL code. 


An anonymous PL/SQL block in a script 


As you learned earlier in this book, a script is a series of SQL statements that 
you can store in a file. In this chapter, you'll learn how to include PL/SQL in a 
script. PL/SQL (Procedural Language/SQL) is Oracle's extension to standard 
SQL that allows you to write procedural SQL code that works with an Oracle 
database. For example, you can use an IF statement to control the execution of a 
script based on a conditional expression, or you can use a loop to execute a 
statement multiple times based on the value of a conditional expression. 

To include PL/SQL within a script, you can code a block of PL/SQL code as 
shown in figure 13-1. Since this block of PL/SQL code doesn't have a name, it is 
known as an anonymous PL/SQL block. In the next chapter, you'll learn how to 
store a named block of PL/SQL code within the database. 

An anonymous PL/SQL block has three main sections. To start, if you want 
to declare variables, you can code the DECLARE keyword, followed by one or 
more statements that declare variables. Then, to code the body of the PL/SQL 
block, you can code the BEGIN keyword, followed by one or more executable 
statements that form the main body of the script. Finally, if you want to handle 
exceptions, you can code the EXCEPTION keyword, followed by one or more 
statements that handle exceptions. Although the PL/SQL block in this figure 
includes all three of these sections, the DECLARE and EXCEPTION parts are 
optional. Later in this chapter, you'll see examples of scripts that don't include 
the DECLARE or EXCEPTION parts of a PL/SQL block. 

In this figure, the script begins by connecting to the database as the AP user. 
Then, it executes a command that allows SQL Developer to display output in its 
Output Script window. Finally, it uses an anonymous PL/SQL block to print a 
message to SQL Developer's Script Output window that indicates the total 
balance due for the vendor. 

As you review this script, note that you must code a semicolon at the end of 
each SQL statement. Similarly, you must code a semicolon after the END IF 
keywords and after the END keyword at the end of the PL/SQL block. In con- 
trast, you don't have to code a semicolon after the CONNECT command because 
it is a command, not a SQL statement. However, it's okay to code one, and I like 
to do that for the sake of consistency. Finally, to execute an anonymous PL/SQL 
block, you must code a front slash (/) after the END keyword for the block. 

For now, don't worry if you don't understand the coding details for this 
anonymous PL/SQL script. Instead, focus on the general ideas. Later in this 
chapter, you'll learn the details that you need to write effective PL/SQL code. 
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The syntax for an anonymous PL/SQL block 


DECLARE 
declaration statement 1; 
[declaration statement 2;]... 
BEGIN 
body statement 1; 
[body statement 2;]... 
EXCEPTION 
WHEN OTHERS THEN 
exception handling statement 1; 
[exception handling statement 2;]... 
END; 
/ 


A script that contains an anonymous PL/SQL block 
CONNECT ap/ap; 


SET SERVEROUTPUT ON; 


-- Begin an anonymous PL/SQL block 
DECLARE 
sum balance due var NUMBER(S, 2); 
BEGIN 
SELECT SUM(invoice total - payment total - credit total) 
INTO sum balance due var 
FROM invoices 
WHERE vendor id = 95; 


IF sum balance due var » 0 THEN 
DBMS OUTPUT.PUT LINE('Balance due: $' || 
ROUND (sum balance due var, 2)); 
ELSE 
DBMS OUTPUT.PUT LINE('Balance paid in full'); 
END IF; 


EXCEPTION 
WHEN OTHERS THEN 
DBMS OUTPUT.PUT LINE('An error occured in the script!); 
END; 
/ 
-- End an anonymous PL/SQL block 


The response from the system 
Connected 

anonymous block completed 
Balance due: $171.01 


Description 


e A scriptis a series of SQL statements that you can store in a file. 


o PL/SQL (Procedural Language/SQL) is Oracle's extension to standard SQL that allows 
you to write procedural code such as IF statements and loops. 


e Ап anonymous PL/SQL block is a block of PL/SQL that's coded within a script. 
e To execute a PL/SQL block, you must code a front slash (/) after the END keyword. 


Figure 13-1 An anonymous PL/SQL block in a script 
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А summary of statements for working with PL/SQL 
and scripts 


Figure 13-2 begins by summarizing the PL/SQL statements that are pre- 
sented in this chapter. These statements can be used within PL/SQL blocks to 
add functionality that's similar to the functionality provided by procedural 
languages. 

After the PL/SQL statements, this figure presents two Oracle commands 
that are commonly used within scripts that contain blocks of PL/SQL code. 
First, it presents the CONNECT command that's used to connect to a database. 
By now, you should understand how this command works. Second, it presents 
the SET SERVEROUTPUT ON command. This command enables printing to 
the SQL*Plus command line or to the Script Output window for recent versions 
of SOL Developer. In the next figure, you can see an example of how it works. 

After the two Oracle commands, this figure presents three procedures that 
are available from the DBMS, OUTPUT package that's included with Oracle 
Database. If you're using an older version of SQL Developer such as version 
1.1, you can use the ENABLE procedure to enable printing to SQL Developer's 
Script Output window. However, if you're using a recent version of SOL 
Developer such as version 1.5, you won't need to use the ENABLE procedure. 
Instead, you use the SET SERVEROUTPUT ON command as shown through- 
out this chapter. Either way, though, you use the PUT and PUT. LINE proce- 
dures to print data to the SQL*Plus command line or to SQL Developer's Script 
Output window. 
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PL/SQL statements for controlling the flow of execution 
Keywords Description 
IF... ELSIF... ELIE Controls the flow of execution based on a condition. 
CASE. . . WHEN. . . ELSE Controls the flow of execution based on a condition. 
FOR...IN...LOOP Repeats statements while a condition is true. 


WHILE...LOOP Repeats statements while a condition is true. 
LOOP...EXIT WHEN Repeats statements while a condition is true. 
CURSOR...IS Defines a result set that can be processed by a loop. 


EXECUTE IMMEDIATE Can be used to execute DDL statements within a script and to 
execute dynamic SQL statements. 


Commands for working with scripts 
Command Description 
CONNECT Connects to the database as the specified user. 


SET SERVEROUTPUT ON Enables printing to SQL Developer's Script Output window or to 
the SQL*Plus command line. 


Procedures for printing output to the screen 
Procedure Description 


DBMS OUTPUT.ENABLE|() Enables printing to SQL Developer's Script Output window for 
versions 1.2 and earlier. 


DBMS_OUTPUT. PUT (string) Prints the specified string without a line break. 
DBMS OUTPUT.PUT_LINE (string) Prints the specified string followed by a line break. 


Description 


e The PL/SQL statements can be used within scripts to add functionality similar to that 
provided by procedural programming languages. 


e The procedures available from the DBMS OUTPUT package that’s included with 
Oracle Database can be used to print output to the screen. 


Figure 13-2 А ѕиттагу of statements for working with PL/SQL and scripts 
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How to code the basic PL/SQL 
statements 


Now that you have a general idea of how to write a block of PL/SQL code, 
you're ready to learn the details for working with PL/SQL. 


How to print data to an output window 


When you develop PL/SQL code, you often need to print data to an output 
window as shown in figure 13-3. For example, you may need to print the value 
of a variable to help you debug some code. 

To start, this figure shows how to print data to the Script Output window 
that's available from Oracle SQL Developer. Here, the main SQL Developer 
window contains a script that begins by calling the SET SERVEROUTPUT ON 
command. This enables the buffer that's used to store the character data that's 
printed to the output window. Then, this script contains an anonymous PL/SQL 
block that uses the РОТ LINE procedure of the DBMS OUTPUT package to 
print some character data to the Script Output window. 

In the Script Output window, you can see the output that was displayed after 
I ran the script in the main window. To start, the first line in the Script Output 
window indicates that the CONNECT command in the script successfully 
connected as the AP user. Then, the second line indicates that the anonymous 
PL/SQL block executed successfully. Finally, the third line shows the message 
that was printed by the script, “Test SQL Developer". Note that all of the 
character data is printed after the anonymous PL/SQL block has finished 
executing. That's because the character data is stored in a buffer until the 
anonymous PL/SQL block finishes executing. 

Although we recommend using SQL Developer to work with PL/SQL code, 
you can use a similar procedure to print data to the SQL*Plus command line if 
you need to. To do that, you begin by calling the SET SERVEROUTPUT ON 
command. Then, you can use the РОТ LINE method of the DBMS, OUTPUT 
package to print the data to the output window. 

Note that some older versions of SQL Developer such as 1.1 and some early 
builds of 1.2 don't yet support the SET SERVEROUTPUT ON command. For 
some of these versions, you can enable printing to the Script Output window by 
calling the ENABLE procedure of the DBMS OUTPUT package. However, 
you must call this procedure from within a PL/SQL block like this: 


BEGIN 

DBMS OUTPUT.ENABLE(); 

DBMS OUTPUT.PUT LINE('Test SQL Developer'); 
END; 
/ 
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How to print data to the SQL*Plus command line 
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Description 


e To print data to SQL Developer's Script Output window or the SQL*Plus command iine, 
call the SET SERVEROUTPUT ON command. Then, use the PUT. LINE procedure of 
the DBMS OUTPUT package to print data. 


Figure 13-3 How to print data to an output window 
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How to declare and use variables 


Figure 13-4 shows how to declare and use variables. More specifically, this 
figure shows how to declare and use a scalar variable, which is a variable that 
contains a single value. 

Within the DECLARE section of a PL/SQL block, you can declare a 
variable by coding a statement that specifies a name and data type for the 
variable. In the script in this figure, for example, the PL/SQL block declares five 
variables. Of these variables, the first two statements use the %TYPE attribute 
to assign the same data type that's used for a column to the variable. For ex- 
ample, the first two variables are declared with the same data type as the 
invoice, total column of the invoices table. Then, the next three specify NUM- 
BER as the data type. When specifying the data type for a variable, you can use 
any of the data types that you can use when you specify the data type for a 
column. 

Once you declare a variable, you can assign a value to it. To assign a literal 
value or the result of an expression, you can code the assignment operator (:=) 
followed by the literal value of the expression. In the script in this figure, for 
example, the last statement in the DECLARE section uses the assignment 
operator to assign a value of 95 to the variable named vendor. id. var. In addi- 
tion, the second statement in the BEGIN section uses the assignment operator to 
assign the result of a calculation to the variable named percent difference. 

If you want to assign a value that's returned by a SELECT statement to a 
variable, you can add an INTO clause to a SELECT statement. In the script in 
this figure, for example, the first statement in the BEGIN section uses the INTO 
clause to assign the three values that are returned by the SELECT statement to 
the corresponding three variables that are specified by the INTO clause. For this 
to work, the SELECT statement must return one value for each of the variables 
that are specified in the INTO clause. In addition, the data types for the columns 
must be compatible with the data types for the variables. 

If you use the %TYPE attribute when you declare the variables, you can be 
sure that a variable will use the same data type as its column. However, using 
this attribute requires more typing and results in code that's more difficult to 
read. As a result, I have hard-coded the data type for most of the variables that 
are used in this chapter. 

To review, the script in this figure uses five variables to calculate the percent 
difference between the minimum and maximum invoices for a particular vendor. 
To do that, this script uses the assignment operator to assign a value to two of 
the variables. In addition, it uses the INTO clause of a SELECT statement to 
assign values to the other three variables. Finally, a series of statements use the 
PUT. LINE procedure of the DBMS OUT package to display the values of four 
of the variables. But first, it calls the SET SERVEROUTPUT ON command to 
enable the buffer that's used to store the data that's printed by the PUT LINE 
procedure. 
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The syntax for declaring a variable 
variable name 1 DATA TYPE; 


The syntax for declaring a variable with the same data type as a column 


variable name 1 table name.column name*sTYPE; 


The syntax for setting a variable to a selected value 


SELECT column l[, column 2]... 
INTO variable name l[, variable name 2]... 


The syntax for setting a variable to a literal value or the result of an 
expression 


variable name :- literal value or expression 


А SQL script that uses variables 
CONNECT ap/ap; 


SET SERVEROUTPUT ON; 


DECLARE 
max invoice total  invoices.invoice total&TYPE; 
min invoice total invoices.invoice total&TYPE; 
percent difference NUMBER; 
count invoice id NUMBER; 
vendor id var NUMBER := 95; 
BEGIN 
SELECT MAX(invoice total), MIN(invoice total), COUNT (invoice id) 
INTO max invoice total, min invoice total, count invoice id 
FROM invoices WHERE vendor id - vendor id var; 


percent difference := (max invoice total - min invoice total) / 
min invoice total * 100; 


DBMS OUTPUT.PUT LINE('Maximum invoice: $' || max invoice total); 
DBMS OUTPUT.PUT LINE('Minimum invoice: $' || min invoice total); 
DBMS OUTPUT.PUT LINE('Percent difference: %! || 
ROUND (percent difference, 2)); 
DBMS OUTPUT.PUT LINE('Number of invoices: ' || count invoice id); 
END; 


/ 


The response from the system 
Connected 

anonymous block completed 
Maximum invoice: $46.21 
Minimum invoice: $16.33 
Percent difference: *182.98 
Number of invoices: 6 


Description 
° A variable is used to store data. А variable that contains a single value is called a scalar 
variable. 


Figure 13-4 How to declare and use variables 
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How to code IF statements 


Figure 13-5 shows how to use an IF statement to execute one or more 
statements based on a value that's returned by a Boolean expression. A Boolean 
expression is an expression that returns a true value or a false value. 

The script in this figure uses an IF statement to test the value of a variable. 
This variable contains the oldest invoice due date in the Invoices table. If this 
due date is less than the current date, the Boolean expression evaluates to true, 
and the statement in the IF clause prints a message to the output window that 
indicates that outstanding invoices are overdue. If the value is equal to the 
current date, the statement in the ELSIF clause prints a message to the output 
window that indicates that outstanding invoices are due today. If neither of these 
conditions is true, the oldest due date must be greater than the current date. As a 
result, the script prints a message to the output window that indicates that no 
invoices are overdue. 

In this figure, the IF statement only contains one ELSIF clause. However, 
you can add as many ELSIF clauses as you need. Аз a result, you can code 
dozens of these clauses if you need them. But if you don't need an ELSIF 
clause, you don't have to code one. For example, it's common to code an IF 
statement without an ELSIF clause like this: 


IF first invoice due date « SYSDATE() THEN 
DBMS OUTPUT.PUT LINE('Outstanding invoices overduel'!); 
ELSE 
DBMS OUTPUT.PUT LINE('No invoices are overdue.!); 
END IF; 
Similarly, the ELSE clause is optional. As a result, it’s common to code an 
IF statement like this: 


IF first invoice due date « SYSDATE() THEN 
DBMS OUTPUT.PUT LINE('Outstanding invoices overduel!); 
END IF; 
When you code IF statements, you can nest one IF statement within another 
For example, you can nest one IF statement within another like this: 


IF first invoice due date «- TRUNC(SYSDATE()) THEN 
DBMS OUTPUT.PUT LINE('Outstanding invoices are overduel!); 
IF first invoice due date - TRUNC(SYSDATE()) THEN 
DBMS OUTPUT.PUT ГІМЕ ('ТОРАҮ!!); 
END ІР) 
END IF; 
In this case, the outer IF statement will be executed when the oldest invoice due 
date is less than or equal to the current date. However, the nested IF statement 
will only be executed when the oldest invoice due date is equal to the current 
date. In other words, if the current date equals the oldest invoice due date, two 
lines will be printed to the output window. As you'll see later in this chapter, 
you can also nest an IF statement within other types of PL/SQL statements such 
as loops. 
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The syntax of the IF statement 


IF boolean_expression THEN 
statement 1; 
[statement 2;]... 

[ELSIF boolean_expression THEN 
statement 1; 
[statement 2;]...]... 

[ELSE 
Btatement 1; 
[statement 2;]...] 

END IF; 


А script that uses an IF statement 
CONNECT ap/ap; 


SET SERVEROUTPUT ON; 


DECLARE 
first invoice due date DATE; 
BEGIN 
SELECT MIN (invoice due date) 
INTO first invoice due date 
FROM invoices 
WHERE invoice total - payment total - credit total > 0; 


IF first invoice due date « SYSDATE() THEN 
DBMS OUTPUT.PUT LINE('Outstanding invoices overduel'); 
ELSIF first invoice due date = SYSDATE() THEN 
DBMS OUTPUT.PUT LINE('Outstanding invoices are due today!'); 
ELSE 
DBMS OUTPUT.PUT LINE('No invoices are overdue.!); 
END IF; 
END; 
/ 


The response from the system 
Outstanding invoices overdue! 


Description 


e You can use an IF statement to execute one or more statements depending on one or 
more Boolean expressions. A Boolean expression is an expression that evaluates to true 
or false. 

e You can nest an IF statement within another IF statement or within other PL/SQL 
statements such as the statements for coding loops. 


Figure 13-5 How to code IF statements 
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How to code CASE statements 


In chapter 8, you learned how to code a CASE expression within a SELECT 
statement. A CASE expression like that usually runs faster than a CASE state- 
ment that's coded within a PL/SQL script. As a result, if you can use a CASE 
expression to solve the task at hand, you should. However, there are times when 
you will need to use a CASE statement as shown in figure 13-6. 

The script in this figure shows how to use a Simple CASE statement to 
execute one or more statements depending on a value that's returned by an 
expression. To do that, you begin by coding the CASE keyword followed by an 
expression that returns a value. In this script, the variable that's coded after the 
CASE statement returns an integer value that indicates the payment terms for an 
invoice. 

After the CASE clause, you can code one or more WHEN clauses that 
contain the statement or statements that are executed for each of the values that 
may be returned. In this example, there are three WHEN clauses for the values 
of 1, 2, and 3. Each of these clauses prints an appropriate message to SQL 
Developer's Script Output window. 

After the WHEN clauses, you can code an optional ELSE clause that's 
executed if the value that's returned doesn't match the values coded in any of 
the WHEN clauses. This works much like the ELSE clause that's available from 
the IF statement. 

Although this figure doesn't show an example of it, you can also use a 
Searched CASE statement to execute one or more statements depending on one 
or more Boolean expressions. This works similarly to an IF statement. For 
example, you can use a Searched CASE statement to replace the IF statement in 
the previous figure like this: 


CASE 
WHEN first invoice due date « SYSDATE() THEN 
DBMS OUTPUT.PUT LINE('Outstanding invoices overdue!'); 
WHEN first invoice due date = SYSDATE() THEN 
DBMS OUTPUT.PUT LINE('Outstanding invoices are due today!'); 
ELSE 
DBM8 OUTPUT.PUT LINE('No invoices are overdue.!); 
END CASE; 


Conversely, you can easily rewrite the Simple CASE statement shown in this 
figure as an IF statement. 

So, when should you use an IF statement and when should you use a CASE 
statement? Although this is largely a matter of personal preference, you usually 
should try to use the statement that yields the code that's easiest to read and 
understand. 
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The syntax of the Simple CASE statement 


CASE expression 
WHEN expression value 1 THEN 
Btatement 1; 
[Statement 2;]... 
[WHEN expression value 2 THEN 
Btatement 1; 
[statement 2;]...]... 
[ELSE 
Btatement 1; 
[statement 2;]...] 
END CASE; 


А script that uses a Simple CASE statement 
CONNECT ap/ap; 


SET SERVEROUTPUT ON; 


DECLARE 
terms id var NUMBER; 

BEGIN 
SELECT terms id INTO terms id var 
FROM invoices WHERE invoice id = 4; 


CASE terms id var 
WHEN 1 THEN 
DBMS OUTPUT.PUT LINE('Net due 10 days'); 
WHEN 2 THEN 
DBMS OUTPUT.PUT LINE('Net due 20 days'); 
WHEN 3 THEN 
DBMS OUTPUT.PUT LINE('Net due 30 days'); 
ELSE 
DBMS OUTPUT.PUT LINE('Net due more than 30 days'); 
END CASE; 
END; 
/ 


The syntax of a Searched CASE expression 


CASE 
WHEN boolean expression THEN 
Btatement 1; 
[Statement 2;]... 
[WHEN boolean expression THEN 
Btatement 1; 
[statement 2;]...]... 
[ELSE 
Statement 1; 
[statement 2;]...] 
END CASE; 


Description 


e You сап use a Simple CASE statement or a Searched Case statement to execute one or 
more statements depending on a value that's returned by an expression. 


Figure 13-6 How to code CASE statements 
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How to code loops 


Figure 13-7 shows how to use a loop to repeat a statement or a block of 
statements while a condition is true. This figure starts by showing how to use a 
FOR loop to continue executing while a counter is within the specified range. In 
the example, the code specifies a counter variable named i that will be increased 
by 1 each time through the loop, starting with a value of 1 and ending with a 
value of 3 (1...3). As a result, the statement within the loop is executed three 
times, once for each of the counter values (1, 2, and 3). The statement within the 
loop just prints the value of the counter variable to the output window. 

The syntax for the FOR loop also shows that you can use the REVERSE 
keyword to execute a FOR loop in reverse order. For example, you could code 
the first line of the FOR loop in this figure like this: 

FOR 1 IN REVERSE 1..3 LOOP 


Then, the loop would yield counter values of 3, 2, and 1. 

After the FOR loop, this figure shows how to use a WHILE loop to continue 
executing until a Boolean expression becomes true. In this example, the WHILE 
loop continues to execute while a counter variable named i is less than 4. To get 
this loop to work, you must first declare the counter variable in the DECLARE 
section. Then, you must assign a value to the counter before you begin the loop, 
and you must increment the counter within the body of the loop. In this ex- 
ample, the last statement in the loop adds a value of 1 to the counter variable. 

Finally, this figure shows how to use a simple LOOP that ends when the 
Boolean expression in the EXIT WHEN clause is true. In the example, the last 
statement in the loop uses an EXIT WHEN statement to exit the loop when the 
counter variable named i is greater than or equal to 4. Here again, the counter 
variable must be declared in the DECLARE section. Alternately, this loop could 
achieve the same result by using an EXIT statement within an IF statement like 
this: 


In the rare case that you need to jump to the beginning of a loop, you can 
use the CONTINUE or CONTINUE WHEN statements. These statements work 
like the EXIT and EXIT WHEN statements, except that they jump to the 
beginning of a loop instead of jumping to the end of a loop. 

Please note that all three of the loops in this figure produce the same result. 
However, the FOR loop uses just three lines of code, the WHILE loops uses five 
lines of code, and the simple loop uses six lines of code. This shows that FOR 
loops are easier to use whenever you need to use a counter variable to loop 
through a range of values. However, there are times when a WHILE loop or a 
simple loop is more appropriate for the task at hand. 


The syntax of the FOR loop 


FOR counter var IN [REVERSE] counter start 
Btatement 1; 
[Statement 2;]... 

END LOOP; 


A FOR loop 


FOR i IN 1..3 LOOP 
DBMS OUTPUT.PUT LINE('i: ' || i); 
END LOOP; 


The syntax for a WHILE loop 


WHILE boolean expression LOOP 
Btatement 1; 
[Statement 2;]... 

END LOOP; 


A WHILE loop 


і := 1; 

WHILE i < 4 LOOP 
DBMS OUTPUT.PUT LINE('i: ' || 1); 
і з= і + 1; 

END LOOP; 


The syntax for a simple loop 


LOOP 

Btatement 1; 

[statement 2;]... 

EXIT WHEN boolean expression; 
END LOOP; 


A simple loop 


l = 1; 

LOOP 
DBMS OUTPUT.PUT LINE('i: ' || 1); 
1:2 i + 1; 
EXIT WHEN i >= 4; 

END LOOP; 


The output for all three loops 


i: 1 
1: 2 
i: 3 


Description 
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..Counter end LOOP 


e То execute a SQL statement repeatedly, you can use a loop. Oracle provides for three 
types of loops: a FOR loop, a WHILE loop, and a simple loop. 


e You can use the EXIT and EXIT WHEN keywords to go to the end of a loop. 
e You can use the CONTINUE and CONTINUE WHEN keywords to go to the beginning 


of the loop. 


Figure 13-7 Ном to code loops 
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How to use a cursor 


By default, SQL statements work with an entire result set rather than 
individual rows. However, there are times when you need to be able to work 
with the data in a result set one row at a time. To do that, you can use a cursor 
as described in figure 13-8. 

The DECLARE section of the script in this figure begins by declaring a 
CURSOR named invoices cursor that contains two columns from the invoices 
table and all of the rows that have a balance due. Then, this script declares a 
variable named invoice row. This declaration uses the 2ROWTYPE attribute to 
indicate that the invoice row variable can store the same data types as a row in 
the invoices table. 

After these two variables have been declared, the BEGIN section uses a 
FOR loop to loop through each row in the cursor. Here, the FOR loop uses the 
invoice, row variable as the counter variable, and it uses the IN keyword to 
specify that the loop should continue for each row in the cursor. Within the FOR 
loop, an IF statement is used to check if the invoice total value of the current 
row is greater than 1000. If so, an UPDATE statement is used to add 10% of the 
invoice total column to the credit total column for the row. Then, it prints a 
message to the output window to show which rows have been updated. 

Before you use a cursor to solve a particular problem, you should consider 
other solutions first. That's because standard database access is faster and uses 
fewer server resources than cursor-based access. For example, you can accom- 
plish the same update as the script in this figure with this UPDATE statement: 


UPDATE invoices 

SET credit total = credit total + (invoice total * .1) 
WHERE invoice total - payment total - credit total > 0 
AND invoice total » 1000 


However, if you encounter a problem where it makes sense to use a cursor, the 
skills presented in this figure should put you on the road to solving the problem. 


Chapter 13 Ноу to write PL/SQL code 


The syntax for declaring a cursor 


CURSOR cursor name IS select statement; 


The syntax for declaring a variable for a row 
row variable name table name*%ROWTYPE; 


The syntax for getting a column value from a row variable 


row variable name.column name 


A script that uses a cursor 
CONNECT ap/ap; 


SET SERVEROUTPUT ON; 


DECLARE 
CURSOR invoices cursor IS 
SELECT invoice id, invoice total FROM invoices 
WHERE invoice total - payment total - credit total > 0; 


invoice row invoicessROWTYPE; 
BEGIN 
FOR invoice row IN invoices cursor LOOP 


IF (invoice row.invoice total > 1000) THEN 
UPDATE invoices 
SET credit total s credit total « (invoice total * .1) 
WHERE invoice id - invoice row.invoice id; 


DEMS OUTPUT.PUT LINE('1 row updated where invoice id = ' || 
invoice row.invoice id); 
END IF; 


END LOOP; 
END; 
/ 


The response from the system 


1 row updated where invoice id = 3 
1 row updated where invoice id = 6 
1 row updated where invoice id = 8 
1 row updated where invoice id - 19 
1 row updated where invoice id = 34 
l row updated where invoice id - 81 
1 row updated where invoice id = 88 
l row updated where invoice id - 113 
Description 


e You can use a cursor to process individual rows in a result set. To do that, you can loop 
through each row in the cursor and process one row at a time. 


Figure 13-8 How to use a cursor 
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How to use collections 


When you need to work with a set of related values, you can typically use a 
cursor as described in the previous figure. However, in some situations, you 
may need to use a collection as described in figure 13-9. A collection is a list of 
related values, and this figure describes all three types of collections that are 
provided by Oracle. 

This first example shows how to use a varray. То start, you declare the type 
of data the varray can store. To do this, you code the TYPE keyword, followed 
by a name for the type, followed by the IS VARRAY keywords, followed by a 
set of parentheses. Within the parentheses, you code a number that indicates the 
number of items that the varray can store. After the parentheses, you code the 
OF keyword, followed by the data type for the items in the varray. In this figure, 
for example, the varray stores three items of the VARCHAR2(25) type. How- 
ever, a varray can store most other Oracle data types as well. 

After you declare the type of the varray, you can declare a variable of that 
type. In addition, you must initialize the variable by assigning initial values to 
each of the items in the varray. In this figure, for example, the statement creates 
a varray of the "names array" type with a name of "names". Then, it initializes 
each value within the array by coding the assignment statement, followed by the 
varray type, followed by a set of parentheses that contains the list of values. In 
this figure, each statement is initialized to a NULL value. However, you can 
also initialize each item to a non-NULL value like this: 


names names array :- names array('John', 'Jane', 'Joel'); 


In that case, you don't need to code the assignment statements shown in this 
figure since values have already been assigned to the items in the list. 

After the DECLARE section, the body of the script begins by setting the 
names for the three items in the names varray. To do that, it uses an integer 
value as an index to access each of the values that are stored in the names 
varray. Note that an index of 1 accesses the first item, an index of 2 accesses the 
second item, and so on. 

After the values have been set, the script uses a FOR loop to get the values 
from the varray, and it prints these values to the output window. To do that, the 
loop declares a counter variable named i that counts from | to the total number 
of items in the varray. Here, the COUNT method of the collection returns the 
total number of items in the varray. Then, the counter variable is used to return 
the value for each of the items in the varray. 

When you declare a varray, it has a fixed size. Аз a result, if you attempt to 
use an index to refer to an item outside the range of the varray, Oracle will raise 
an error. For example, Oracle will raise an error if you refer to a fourth element 
like this: 

names(4) := 'Jack'; 

In contrast, when you declare a nested table as shown in the second ex- 
ample, you don’t declare a size for the list. Instead, you code the TABLE 
keyword. Other than that, though, nested tables work similarly to varrays. If you 
want to increase the number of elements that are stored by the list, though, you 
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The syntax for declaring a varray 


TYPE type name IS VARRAY(count) OF data type; 
coll name type name := type name(valuel [, value2]...); 


The syntax for setting a value in a collection 


coll name(index) := value; 


The syntax for getting a value from a collection 


var name :- coll name(index); 


А script that uses a varray 


DECLARE 

TYPE names array IS VARRAY(3) OF VARCHAR2 (25); 

names names array := names array(NULL, NULL, NULL); 
BEGIN 


names(1) = 'John!; 
names (2) = 'Jane'; 
names(3) з= 'Joel'; 


FOR 1 IN 1..names.COUNT LOOP 
DBMS OUTPUT.PUT LINE('Name ' || 1 || ': ' || mames(i)); 
END LOOP; 
END; 
/ 


The response from the system 
Name 1: John 
Name 2: Jane 
Name 3: Joel 


The syntax for declaring a nested table 


TYPE type name IS TABLE OF data type; 
coll name type name := type name(valuel [, value2]...)3 


А script that uses a nested table 


DECLARE 

TYPE names table IS TABLE OF VARCHAR2 (25); 

names names table := names table(NULL, NULL, NULL); 
BEGIN 

names(1) :- 'John'; 

names(2) := 'Jane!; 

names(3) з= 'Joel'; 


FOR 1 IN 1..names.COUNT LOOP 
DBMS OUTPUT.PUT LINE('Name ' || i || ': ' || names(1)); 
END LOOP; 
END; 
/ 


Description 
e You can use a collection to store а list of related values. 


e Oracle provides three types of collections: varrays, nested tables, and associative arrays 
(which were known as index-by tables prior to Oracle Database 10g). 


Figure 13-9 Ном to use collections (part 1 of 2) 
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can call the EXTEND method and specify the number of elements that you 

want to add. If, for example, you want to add one item to the names collection 

presented in the second example, you can code the EXTEND method like this: 
names.EXTEND(1); 

Then, you can use the fourth index to set a value for the new item like this: 
names(4) := 'Jack'; 

The third example shows how to use an associative array. Prior to Oracle 
10g, associative arrays were known as index-by tables. Regardless of the name, 
this type of collection works similarly to nested tables. However, the index 
values for the collection don’t have to be sequential, and they don’t have to be 
integers. In addition, the size of the collection is increased automatically when- 
ever that’s necessary. 

When you declare an associative array, you begin with a syntax that’s 
similar to the syntax for declaring nested tables. Then, you code the INDEX BY 
keywords followed by the data type for the index. Here, you can specify the 
BINARY_INTEGER or PLS_INTEGER type for an integer index or the 
VARCHAR? type for a string index. 

After the DECLARE section, the body of the script uses non-sequential 
integers as the indexes for the items. Then, a FOR statement uses the FIRST and 
LAST methods of the collection to loop from the first index in the list to the last 
index in the list. In other words, it loops from 76 to 123. Within the body of the 
FOR loop, an IF statement uses the EXISTS method to check if a value exists 
for the specified index. If so, it prints the value for the item to the output win- 
dow. This prevents an error that occurs if you attempt to access an item that 
doesn't exist in the list. 

The fourth example shows how to use a SELECT statement to fill a collec- 
tion with values. This example begins by declaring a nested table of the 
VARCHAR2(40) type and assigning this nested table to a variable named 
vendor names. Then, the body of the script uses a SELECT statement with a 
BULK COLLECT clause to fill this variable with values that are selected from 
the vendor name column of the Vendors table. In this example, the SELECT 
statement uses the ROWNUM pseudo column to return three rows. However, 
you can use the same technique to fill a variable with a large number of values. 

Note that the syntax for using the BULK COLLECT clause is similar to the 
syntax for setting a variable to a single selected value. However, with a BULK 
COLLECT clause, the target variable must be defined as one of the collection 
types. 

At this point, you may be wondering when you will need to use collections. 
To answer that question, you can refer to figure 16-10 of chapter 16. This figure 
shows how collections can be used to fix a common Oracle error. 
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The syntax for declaring an associative array 


TYPE type name IS TABLE OF data type [NOT NULL] 
INDEX BY {РІЗ INTEGER|BINARY INTEGER | VARCHAR2 (size) }; 
coll name type name := type name(valuel [, value2]...); 


A script that uses an associative array 


DECLARE 
TYPE names table IS TABLE OF VARCHAR2 (25) 
INDEX BY BINARY INTEGER; 
names names table; 
BEGIN 
names(76) := 'John'; 
names(100) := !Јапе!; 
names (123) :- 'Joel'; 


FOR 1 IN names.FIRST..names.LAST LOOP 
IF names.EXISTS(i) THEN 


DBMS OUTPUT.PUT LINE('Name ' || i || ': ' || names(1)); 
END IF; 
END LOOP; 
END; 
/ 
А script that uses a BULK COLLECT clause to fill a collection 
DECLARE 
TYPE names table IS TABLE OF VARCHAR2 (40); 
vendor names names table; 
BEGIN 


SELECT vendor name 

BULK COLLECT INTO vendor names 
FROM vendors 

WHERE rownum « 4 

ORDER BY vendor id; 


FOR i IN 1..vendor_names.COUNT LOOP 
DBMS OUTPUT.PUT LINE('Vendor name ' || i || ': ' || vendor_names(i)); 
END LOOP; 
END; 
/ 


The response from the system 

Vendor name 1: US Postal Service 

Vendor name 2: National Information Data Ctr 
Vendor name 3: Register of Copyrights 


Description 


e Varrays have a fixed size that's declared at compile-time. The size of nested tables and 
associative arrays can be dynamically adjusted at runtime. 


e ‘You can use the methods of a collection (such as the COUNT, FIRST, LAST, and 
EXISTS methods) to work with a collection. 


e You can use the BULK COLLECT clause of a SELECT statement to retrieve a list of 
values into a collection. 


Figure 13-9 Ном to use collections (part 2 of 2) 
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How to handle exceptions 


Figure 13-10 shows how to use the EXCEPTION section of a PL/SQL 
block to handle the exceptions that may occur in your PL/SQL code. This is 
often referred to as exception handling or error handling. 

This figure begins by showing a script that doesn't handle exceptions. Here, 
the INSERT statement attempts to insert a duplicate value (“Cash”) into a 
column (account, description) that has been defined with a unique key. This 
causes Oracle to raise an exception. Since this exception isn't handled, this 
causes the system to display an error message like the one that's shown. 

Although error messages like this can be helpful to a developer when PL/ 
SQL code is being developed, they aren't helpful to the end user of an applica- 
tion. Ás a result, you typically want to handle exceptions before you put your 
PL/SQL code into production. To do that, you can begin by looking up any 
errors that you discover during testing as described in the next figure. If, for 
example, you look up error number 00001, you'll see that it has a name of 
DUP VAL, ON. INDEX. Then, you can use the EXCEPTION section of a PL/ 
SQL block to display a more user-friendly message to the user. Or, you can use 
the EXCEPTION section to perform other error handling tasks such as writing 
information about the error to a log table or rolling back a transaction. 

The second script in this figure handles two exceptions: (1) the 
DUP VAL ON INDEX exception that's thrown by the first script, and (2) any 
other exceptions that may be thrown. To do that, this script includes an EXCEP- 
TION section that has two WHEN clauses. Here, the first WHEN clause handles 
the ООР VAL ON INDEX exception by printing a user-friendly message to 
the output window. Then, the second WHEN clause uses the OTHERS keyword 
to handle all other exceptions by printing two lines to the output window. Within 
this clause, the first statement prints a user-friendly message that indicates that 
an unexpected exception has occurred. Then, the second statement prints the 
error number and message that are returned by the built-in SQLERRM function. 
Since the second WHEN clause handles all exceptions, it must be coded last. 
Otherwise, you'll get an error when you attempt to run your script. 

To test this script, you can change the values in the INSERT statement. If 
you run the statement as shown in this figure, the script will print the line shown 
in the first WHEN clause. If you enter 'xx' as the first value for the INSERT 
statement, the script will print the first line shown in the second WHEN clause. 
Then, it will print the string that's returned by the SQLERRM function. To- 
gether, these two lines will look something like this: 

An unexpected exception occurred. 

ORA-01722: invalid number 
Finally, if you enter valid values, the script will print a message that indicates 
that 1 row was inserted. 
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A script that doesn’t handle exceptions 


CONNECT ap/ap; 
INSERT INTO general ledger accounts VALUES (130, 'Cash'); 


The response from the system 


SQL Error: ORA-00001: unique constraint (AP.GL ACCOUNT DESCRIPTION UQ) violated 
00001. 00000 - "unique constraint (*5.*5) violated" 
*Cause: An UPDATE or INSERT statement attempted to insert a duplicate key. 
For Trusted Oracle configured in DBMS MAC mode, you may see 
this message if a duplicate entry exists at a different level. 
*Action: Either remove the unique restriction or do not insert the key. 


The syntax of the EXCEPTION block 


EXCEPTION 
WHEN most specific exception THEN 
Btatement 1; 
[statement 2;1... 


[WHEN less specific exception THEN 
statement 1; 
[statement 2;]...]... 


А script that uses the EXCEPTION block to handle exceptions 


CONNECT ap/ap; 
SET SERVEROUTPUT ON; 


BEGIN 
INSERT INTO general ledger accounts VALUES (130, 'Cash!); 


DBMS OUTPUT.PUT LINE('1 row inserted.'); 
EXCEPTION 
WHEN DUP VAL ON INDEX THEN 
DBMS OUTPUT.PUT LINE('You attempted to insert a duplicate value.'); 


WHEN OTHERS THEN 
DBMS OUTPUT.PUT LINE('Àn unexpected exception occurred.'); 
DBMS OUTPUT.PUT LINE(SQLERRM); 
END; 
/ 


The response from the system 


You attempted to insert а duplicate value. 


Description 


e Ina PL/SQL block, you can use the EXCEPTION block to handle exceptions. This is 
referred to as exception handling or error handling. 


e Within a WHEN clause, you can specify the name of a specific exception to handle, or 
you can use the OTHERS keyword to handle all exceptions that haven’t been handled by 
a previous WHEN clause. 


e Within a WHEN clause, you can use the SQLERRM function to return a string that 
contains an error number and message for the error that was raised. 


Figure 13-10 How to handle exceptions 
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A list of predefined exceptions 


Figure 13-11 shows four of the predefined exceptions that are defined and 
raised by Oracle. These exceptions should give you an idea of the types of 
predefined exceptions that are provided by Oracle. For example, the first 
exception in this list shows the DUP VAL, ON, INDEX exception that was 
described in the previous figure. Note that its ORA error number (00001) 
corresponds with the error number that's shown in the error message in the 
previous figure. 

In all, Oracle provides over 20 predefined exceptions. For a complete list of 
these exceptions, you can search the Oracle Database PL/SQL Language 
Reference manual for “predefined PL/SQL exceptions". 

In most cases, you can use the predefined exceptions to handle the excep- 
tions that you encounter. In some cases, though, you may need to use user- 
defined exceptions, which are exceptions that have been defined by a DBA or 
another developer. If, for example, you're developing stored procedures or 
functions as described in the chapter 15, you may need to create your own user- 
defined exceptions. Since most application developers don't need to do that, 
though, that skill isn't covered in this book. 
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A list of commonly used exceptions 


00001 DUP VAL ON INDEX Occurs when a program attempts to store duplicate values in a 


column that has a unique constraint or index. 
01403 NO DATA FOUND Occurs when a SELECT INTO statement doesn't return any 
data. 
01476 ZERO DIVIDE Occurs when a program attempts to divide a number by zero. 
01722 INVALID NUMBER Occurs when a program fails to convert a string into a number. 


This is usually because the characters in the string do not form 
a valid number. 


06502 VALUE ERROR Occurs when a program encounters an arithmetic, conversion, 
truncation, or size-constraint error. 


Description 
e Oracle provides predefined exceptions for exceptions that commonly occur. 


e Foracomplete list of the predefined exceptions provided by Oracle, you can search the 
Oracle Database PL/SQL Language Reference manual for "predefined PL/SQL excep- 
tions". 

e In most cases, you can use the predefined exceptions provided by Oracle to handle 
exceptions. However, in some cases, you may need to use user-defined exceptions, which 
are exceptions that have been defined by a DBA or another developer. 

e To learn more about user-defined exceptions, look up “user-defined exceptions" in the 
PL/SQL Reference manual. 


Figure 13-11  Alist of predefined exceptions 
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Other scripting and PL/SQL skills 


The remaining topics of this chapter present some additional techniques you 
can use to work with the scripts and PL/SQL code that you write. 


How to drop database objects without displaying 
errors 


Frequently, you'll need to write scripts that create database objects. For 
example, the script that you used to create the AP schema creates all of the 
tables and sequences for the database. However, if you attempt to create an 
object that already exists, Oracle returns an error and the script doesn't execute 
correctly. For example, if you try to create the Vendors table and that table 
already exists, Oracle returns an error that indicates that the table can't be 
created because it already exists. 

To solve this problem, you can code a DROP statement that drops the 
database object before you create it as shown by the first script in figure 13-12. 
Although that allows the script to successfully create the table, it also causes an 
error to be displayed if the database object doesn't exist. For example, if the 
table named Test1 doesn't exist, this script will display an error like the one 
that's shown. 

To solve this problem, you can use an anonymous PL/SQL block to handle 
the error as shown by the second script in this figure. Here, the BEGIN section 
of the PL/SQL block uses the EXECUTE IMMEDIATE command to execute 
the DROP TABLE statement that drops the table named Test1. This is necessary 
because you can't execute a DDL statement such as a DROP TABLE statement 
within a PL/SQL block. Instead, you must use the EXECUTE IMMEDATE 
command to execute a string that contains the DDL command. Note that the 
EXECUTE IMMEDIATE command was introduced with Oracle 9i. 

Then, the EXCEPTION section of the PL/SQL block handles this error by 
using the NULL statement to do nothing. This is known as squelching an error, 
and it prevents the error message from being displayed. Although squelching 
errors is generally considered a bad practice, it's helpful in this example since 
you want to prevent the error message from being displayed. 
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The syntax of the EXECUTE IMMEDIATE statement 


EXECUTE IMMEDIATE 'sql string' 


А script that will display an error if the object doesn't already exist 
CONNECT ap/ap; 
DROP TABLE testl; 
CREATE TABLE testl (test id NUMBER); 


The response from the system 
Connected 


Brror starting at line 2 in command: 

DROP TABLE testl 

Brror report: 

SQL Error: ORA-00942: table or view does not exist 
00942. 00000 - "table or view does not exist" 
*Cause: 

*Action: 

CREATE TABLE succeeded. 


A script that will execute correctly without displaying an error 
CONNECT ap/ap; 


BEGIN 
EXECUTE IMMEDIATE 'DROP TABLE testl'!'; 
EXCEPTION 
WHEN OTHERS THEN 
NULL; 
END; 
/ 


CREATE TABLE testl (test id NUMBER); 


The response from the system 
Connected 

anonymous block completed 
CREATE TABLE succeeded. 


Description 


e You can't execute DDL statements within a PL/SQL block. However, as of Oracle 9i, 
you can use the EXECUTE IMMEDIATE statement to execute a string that contains a 
DDL statement. 


e ‘You can use the NULL statement if a clause requires a statement but you don't want to 
execute any code. 


Figure 13-12 How to drop database objects without displaying errors 
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How to use bind variables 


Figure 13-13 begins by showing how to use a bind variable, which is a 
special type of variable that has several advantages over a regular variable. First, 
SQL statements that use bind variables usually run more efficiently than SQL 
statements that concatenate a regular variable. As a result, you should use bind 
variables whenever efficiency is a concern. For example, Oracle will be able to 
cache the SELECT statement shown in this figure and substitute the bind 
variable. This runs more efficiently than concatenating a regular variable to the 
end of the SELECT statement. 

Second, a bind variable can be used in regular SQL statements that are 
executed outside of a PL/SQL block. In this figure, for example, the SELECT 
statement that uses the bind variable named invoice id value isn't coded within 
a PL/SQL block. 

Third, a bind variable stays in scope for an entire script. More accurately, a 
bind variable stays in scope for the entire SQL Developer or SQL *Plus session. 
As a result, you can use a bind variable across all statements in a script. In this 
figure, for example, the bind variable named invoice id value is used in the first 
PL/SQL block, the SELECT statement that follows, and the second PL/SQL 
block. 

To declare a bind variable, you code a statement that starts with the VARI- 
ABLE keyword. This works similarly to declaring a regular PL/SQL variable 
except that you must begin the statement with the VARIABLE keyword. In 
addition, you must code this statement outside of a PL/SQL block, which makes 
sense when you consider that the scope of a bind variable is larger than a single 
PL/SQL block. 

After you declare a bind variable, you can reference it by prefacing it with a 
colon (:). In this figure, for example, all statements that use the bind variable 
named invoice id, value preface it with a colon. 


How to use substitution variables 


If you want to prompt the user to enter a variable, you can code a substitu- 
tion variable. À substitution variable causes SQL Developer or SQL*Plus to 
prompt the user who runs the script to enter a value that's substituted for the 
substitution variable. You code a substitution variable by prefacing the variable 
name with an ampersand (&). In this figure, for example, the statement in the 
first PL/SQL script uses a substitution variable named invoice, id to assign a 
value to the bind variable. 

As a result, if you use SQL Developer to run this script, SOL Developer 
will display a dialog box that prompts the user to enter a value for the 
invoice id variable, as shown in this figure. Then, this value is assigned to the 
bind variable. In this example, I entered a value of 1 for the substitution vari- 
able. However, I could have entered any valid invoice ID, and the script would 
have executed successfully. 
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A script that uses bind variables 


CONNECT ap/ap; 
SET SERVEROUTPUT ON; 


-- Use the VARIABLE keyword to declare a bind variable 
VARIABLE invoice id value NUMBER; 


-- Use a PL/SQL block to set the value of a bind variable 
-- to the value that's entered for а substitution variable 
BEGIN 

:invoice id value := &invoice id; 
END; 
/ 


-- Use a bind variable in a SELECT statement 
SELECT invoice id, invoice number 

FROM invoices 

WHERE invoice id = :invoice id value; 


-- Use а bind variable in another PL/SQL block 
BEGIN 
DBMS OUTPUT.PUT LINE('invoice id value: ' || :invoice id value); 
END; 
/ 


The dialog box that prompts for a substitution variable 


Enter Substitution Variable 


IN¥OICE_ID: 


4 


The response from the system 


Connected 

anonymous block completed 

INVOICE ID INVOICE NUMBER 
1 QP58872 


1 rows selected 


anonymous block completed 
invoice id value: 1 


Description 


A bind variable stays in scope for an entire script and can be used in SQL statements or 
in PL/SQL blocks. To code a bind variable, preface the variable name with a colon (:). 


A substitution variable causes SQL Developer to prompt the user who runs the script to 
enter a value for the substitution variable. To code a substitution variable, preface the 
variable name with an ampersand (&). 


Figure 13-13 How to use bind variables and substitution variables 
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How to use dynamic SQL 


So far, most of the scripts you've seen in this chapter have contained hard- 
coded SQL statements. In other words, the SQL statements don't change from 
one execution of the script to another. In contrast, when you use dynamic SQL, 
you define a SQL statement as a script executes. Then, you use the EXECUTE 
IMMEDIATE statement to execute the SQL that was dynamically generated by 
the script. 

Figure 13-14 shows how you can use the EXECUTE IMMEDIATE state- 
ment to execute a dynamic SQL statement. To start, the script in this figure 
declares three variables. The first two variables are used to store the values of 
the invoice ID and the terms ID, and the third variable is used to store the 
dynamic SQL statement. 

After the DECLARE section, the body of the script begins by using substi- 
tution variables to set the values for the invoice ID and terms ID variables. 
Then, it builds an UPDATE statement by concatenating these values with some 
string literals, and it assigns the UPDATE statement to the variable named 
dynamic sql. Finally, this code uses the EXECUTE IMMEDIATE command to 
execute the UPDATE statement that's stored in the dynamic, sql variable. 

The EXECUTE IMMEDIATE statement is part of the Native Dynamic SQL 
(NDS) feature that was introduced with Oracle 9i. Prior to Oracle 9i, you needed 
to use the DBMS SQL package to work with dynamic SQL. In general, NDS 
provides many advantages over the DBMS , SQL package. In particular, it runs 
faster, has a more intuitive syntax, and provides features that aren't available 
from the DBMS, SQL package. Аз a result, if you're using Oracle 9i or later, 
you'll usually want to use NDS instead of the DBMS SQL package. 
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Dynamic SQL that updates the terms ID for the specified invoice 
CONNECT ap/ap; 


DECLARE 
invoice id var NUMBER; 
terms id var NUMBER; 
dynamic sql VARCHAR2 (400) ; 


BEGIN 
invoice id var := &invoice id; 
terms id var :- &terms id; 


dynamic sql := 'UPDATE invoices ' || 
'SET terms id = ' || terms id var || ' ' || 
'WHERE invoice іа = ' || invoice id var; 


EXECUTE IMMEDIATE dynamic sql; 
END; 
/ 
The first dialog box that prompts for a substitution variable 


Enter Substitution Variable |x| 


INVOICE ID: 


114| 


The second dialog box that prompts for a substitution variable 


Enter Substitution Variable El 


TERMS, ID: 


The contents of the variable named dynamic sql at runtime 
UPDATE invoices SET terms id = 3 WHERE invoice id = 114 


Description 


e You can use a PL/SQL block to build a string variable that contains a SQL statement. 
Then, you can use the EXECUTE IMMEDIATE statement to execute the statement 
contained in the string. This is known as dynamic SQL. 

e The EXECUTE IMMEDIATE statement is part of Native Dynamic SQL (NDS), which 
was introduced with Oracle 9i. Prior to Oracle 9i, you needed to use the DBMS. SQL 
package to work with dynamic SQL. 


Figure 13-14 How to use dynamic SQL 


439 


440 Section 4 Тһе essential PL/SQL skills 


How to run a script from a command line 


Figure 13-15 shows how you can use SQL*Plus to run SQL scripts from a 
command line. This provides a way to use a DOS batch file or a Unix shell 
script to run a SQL script, which in turn provides an easy way for an end user to 
execute a SQL script. On a Windows system, for example, a user can execute a 
batch file that executes a SQL script by double-clicking on the batch file. 

This figure begins by showing a SQL script that creates a user named AR 
and creates a table named Customers within this user's schema. To start, this 
script uses a SPOOL command to write the output for the script to a log file 
named create, ar.log. If the script doesn't execute successfully this log file can 
be used to troubleshoot problems with the script. 

After the SPOOL command, this script uses the PROMPT command to 
write a message to the log file and also to the command prompt. Then, it uses a 
second PROMPT command to write a blank line. 

After the PROMPT commands, this script uses a PL/SQL block to drop the 
AR user and any objects that exist within this user's schema. Then, it creates the 
AR user and grants privileges to the AR user. 

After creating the AR user, this script uses the PROMPT command to write 
another message and another blank line to the log file and the command prompt. 
Then, it connects as the AR user, creates the Customers table, and inserts three 
rows into this table. 

After creating the Customers table, this script uses the SPOOL OFF com- 
mand to finish writing to the log file. Then, it uses the PROMPT command to 
write another message and another blank line to the command prompt. Finally, 
this script uses the EXIT command to exit from SQL*Plus. 
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The code for the create ar.sql script 
SPOOL create ar.log; 


PROMPT Creating AR user... 
PROMPT 


CONNECT system/system; 
BEGIN 

EXECUTE IMMEDIATE 'DROP USER ar CASCADE!; 
EXCEPTION 

WHEN OTHERS THEN 

NULL; 

END; 
/ 
CREATE USER ar IDENTIFIED BY ar DEFAULT TABLESPACE users; 
GRANT ALL PRIVILEGES TO ar; 


PROMPT Creating AR tables... 
PROMPT 


CONNECT ar/ar; 
CREATE TABLE customers 
( 


customer id NUMBER NOT NULL, 
customer first name VARCHAR2 (50) NOT NULL, 
customer last name VARCHAR2 (50) NOT NULL, 


CONSTRAINT customers pk 
PRIMARY KEY (customer id) 
); 
INSERT INTO customers VALUES (1, 'Jack!', 'Samson!); 
INSERT INTO customers VALUES (2, 'Joan', 'Redding'); 
INSERT INTO customers VALUES (3, 'Jim', 'Abbot!); 


SPOOL OFF; 


PROMPT Check create ar.log for details... 
PROMPT 


EXIT; 


Figure 13-15 How to run a script from the command line (part 1 of 2) 
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Figure 13-15 continues by showing the code for the DOS batch file named 
create ar.bat. To start, this batch file uses the 9ECHO OFF command to 
prevent the commands that are executed by the batch file from being displayed 
(echoed) in the DOS window. 

Then, this batch file uses the SQLPLUS command to use SQL *Plus to run 
the SQL script named create, ar, which is the SQL script shown in the previous 
figure. Here, the SOLPLUS command connects to the database as the user 
named system using a password of system. Note that this works because the 
create ar.bat and create аг.541 files are stored іп the same directory. If these 
files weren't stored in the same directory, you would need to qualify the name 
of the SQL script with a complete path. Note also that you don't need to include 
the .sql extension for the file that stores the script. 

After executing the SQL script, this batch file uses the ECHO command to 
print a blank line, print a message that the batch file has finished, and print 
another blank line to the DOS window. 

Finally, this batch file uses the PAUSE command to display the ‘Press any 
key to continue' message that's displayed at the end of the command prompt. 
Without this command, the DOS window would automatically close, and the 
user wouldn't be able to review the output that has been printed to the DOS 
window. Although it isn't critical to display this window, it lets the user review 
the messages that have been printed to the window by the SQL script and the 
DOS batch file. That way, the user can confirm that the script executed success- 
fully. Or, if the output shows that the script encountered errors, the user can use 
this information to troubleshoot the problem. 
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The code for the create_ar.bat file 


@ECHO off 


:: Use SQL*Plus to run the create ar.sql script 
SQLPLUS system/system Gcreate ar 


:: Display a message about the log file 
ECHO. 


ECHO The create ar.bat file has finished running. 
ECHO. 


:: Display 'press any key to continue' message 
PAUSE 


The output that's displayed in the DOS window 


Grant succeeded. 
Creating AR tables... 
Connected. 


Table created. 
row created. 
row created. 


row created. 


Check create. ar.log for details... 


Disconnected from Oracle Database 1@q Express Edition Release 18.2.8.1.8 — Prodi 
et bois 


[he create ar.bat file has finished running. 


Description 


e You can use the SOLPLUS command to execute SQL scripts from a command line. This 
provides a way to use a DOS batch file or a Unix shell script to run a SQL script. 


e Опа Windows system, you can execute a batch (*.bat) file by double-clicking on it after 
you find it in the Windows Explorer. 


Figure 13-15 Ном to run a script from the command line (part 2 of 2) 
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Perspective 


In this chapter, you learned how to use PL/SQL to write procedural code. You 
also learned how to use dynamic SQL to solve problems that can't be solved using 
any other technique. By using these techniques, you'll be able to code scripts that 
are more general, more useful, and less susceptible to failure. 

In the next three chapters, you'll learn more about the use of PL/SQL code. In 
chapter 14, you'll learn how to manage transactions and locking. In chapter 15, 
you'll learn how to code stored procedures and functions, which are essentially 
named blocks of PL/SQL code that are stored within the database as objects. And 
in chapter 16, you'll learn how to code triggers. When you finish those chapters, 
you'll have a much better perspective on the use of PL/SQL. 


Terms 


script 

PL/SQL 

anonymous PL/SQL block 
variable 

scalar variable 

IF statement 

Boolean expression 
nested statements 

Simple CASE statement 
Searched CASE statement 
loop 

FOR loop 

counter 

WHILE loop 

simple loop 

cursor 


collection 

varray 

nested table 
associative array 
index-by table 
exception handling 
error handling 
predefined exception 
user-defined exception 
squelching an error 
dynamic SQL 

Native Dynamic SQL (NDS) 
bind variable 
substitution variable 
DOS batch file 

UNIX shell script 
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Exercises 


1. 


Write a script that declares and sets a variable that's equal to the count of all 
rows in the Invoices table that have a balance due that's greater than or equal to 
$5,000. Then, the script should display a message that looks like this: 


3 invoices exceed $5,000. 


Write a script that uses variables to get (1) the count of all of the invoices in the 
Invoices table that have a balance due and (2) the sum of the balances due for all 
of those invoices. If that total balance due is greater than or equal to $50,000, the 
script should display a message like this: 

Number of unpaid invoices is 40. 

Total balance due is $66,796.24. 

Otherwise, the script should display this message: 

Total balance due is less than $50,000. 


Write a script that creates a cursor consisting of vendor, name, invoice, number, 
and balance due for each invoice with a balance due that's greater than or equal 
to $5,000. The rows in this cursor should be sorted in descending sequence by 
balance due. Then, for each invoice, display the balance due, invoice number, 
and vendor name so it looks something like this: 

$19,351.18 P-0608 Malloy Lithographing Inc 


Enhance your solution to exercise 3 so it shows the invoice data in three groups 
based on the balance due amounts with these headings: 

$20,000 or More 

$10,000 to $20,000 

$5,000 to $10,000 

Each group should have a heading followed by the data for the invoices that fall 
into that group. Also, the groups should be separated by one blank line. 


Enhance your solution to exercise 3 so it uses a substitution variable to set a bind 
variable that you use to determine what the minimum balance due should be for 
the invoices that the SELECT statement is going to retrieve. You should also use 
this bind variable to display a heading like this before the list of invoices: 


Invoice amounts greater than or equal to $2,000 


where 2,000 is the value of the bind variable. 
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How to manage 
transactions and locking 


If you've been working with Oracle on your own computer, you've been the 
only user of your database. In the real world, though, a database may be used 
by thousands of users at the same time. Then, what happens when two users try 
to update the same data at the same time? In this chapter, you'll learn how 
Oracle handles this situation. But first, you'll learn how to combine multiple 
SQL statements into a single logical unit of work known as a transaction. 
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How to work with transactions 


A transaction is a group of SQL statements that you combine into a single 
logical unit of work. By combining SQL statements like this, you can prevent 
certain kinds of database errors. 


How to commit and rollback transactions 


Figure 14-1 starts by presenting a script that includes a PL/SQL block that 
contains three INSERT statements that are coded as a transaction. Here, the first 
INSERT statement adds a new invoice to the Invoices table. The next two 
INSERT statements add the line items for the invoice to the Invoice Line Items 
table. And the COMMIT statement commits the changes to the database, which 
makes the changes permanent. 

On the other hand, if any of the INSERT statements causes an error, the 
execution of the script will jump into the EXCEPTION part of the PL/SQL 
block. Then, the first statement in the WHEN OTHERS THEN clause uses the 
ROLLBACK statement to undo, or rollback, all three INSERT statements. 

To understand why this is necessary, suppose that you split the INSERT 
statements into three separate transactions by coding a COMMIT statement 
after each of the INSERT statements. Then, what will happen if the third 
INSERT statement fails? In that case, the Invoices and Invoice Line Items 
tables won't match. Specifically, the sum of the line item amt columns in the 
Invoice, Line Items table won't be equal to the invoice total column in the 
Invoices table. In other words, the data integrity won't be maintained. 

Similarly, consider the example of a transfer between a checking and a 
savings account in a banking system. In that case, one update reduces the 
balance in the checking account and another update increases the balance in the 
savings account. Then, if one of these updates fails, the customer either gains or 
loses the amount of the transaction. But here again, treating the two updates as a 
single transaction solves this problem. 

As you work with Oracle, remember that it doesn't automatically commit 
INSERT, UPDATE, and DELETE statements after you execute them as some 
database management systems do. As a result, you need to get into the habit of 
explicitly coding COMMIT and ROLLBACK statements when you write code 
that works with these statements. 
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А script that contains three INSERT statements that are coded as a trans- 
action 


CONNECT ap/ap; 
SET SERVEROUTPUT ON; 


BEGIN 
INSERT INTO invoices 
VALUES (115, 34, 'ZXA-080', '30-AUG-06', 
14092.59, 0, 0, 3, '30-SEP-06!', NULL); 


INSERT INTO invoice line items 
VALUES (115, 1, 160, 4447.23, 'HW upgrade'); 


INSERT INTO invoice line items 
VALUES (115, 2, 167, 9645.36, 'OS upgrade!'); 


COMMIT; 
DBMS OUTPUT.PUT LINE('The transaction was committed.'); 
EXCEPTION 
WHEN OTHERS THEN 
ROLLBACK; 
DBMS OUTPUT. PUT LINE('The transaction was rolled back.'); 
END; 
/ 


When to use transactions 


When you code two or more INSERT, UPDATE, or DELETE statements that affect 
related data. 


When you move rows from one table to another table by using INSERT and DELETE 
Statements. 

Whenever the failure of an INSERT, UPDATE, or DELETE statement would violate data 
integrity. 


Description 


A transaction is one or more SQL statements that perform a logical unit of work. 


By default, Oracle doesn’t commit the changes made by your INSERT, UPDATE, and 
DELETE statements until you explicitly commit them. To do that, you code a COMMIT 
statement after one or more SQL statements. 


If one or more SQL statements within a PL/SQL block encounters an error, you can code 
a ROLLBACK statement to rollback the changes. 


Oracle automatically executes a COMMIT statement after a DDL statement such as a 
CREATE TABLE statement or if the application exits successfully. 


Oracle automatically executes a ROLLBACK statement if the application crashes. 


Figure 14-1 How to commit and roll back transactions 
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How to work with save points 


The script in figure 14-2 shows how to use the SAVEPOINT statement to 
identify one or more save points within a transaction. Here, a SAVEPOINT 
statement is used to identify a save point before each of the three INSERT 
statements that are included in the script. Аз a result, the script includes three 
save points. 

This script also shows how to use the ROLLBACK TO statement to rollback 
all or part of a transaction. Here, the three ROLLBACK TO statements rollback 
the transaction to each of the three save points. The first ROLLBACK TO 
statement rolls back to the point before the second line item was inserted. The 
second statement rolls back to the point before the first line item was inserted. 
And the third statement rolls back to the point before the invoice was inserted. 

At this point, the script calls the COMMIT statement to commit any 
changes that have been made. However, the three ROLLBACK TO statements 
have rolled back all three INSERT statements, so this doesn't commit any 
changes to the database. To verify this, you can use a SELECT statement to 
view the rows in the Invoices and Invoice Line Items tables that have an 
invoice id of 115. 

In general, save points are used when a transaction contains so many 
statements that rolling back the entire transaction would be inefficient. In that 
case, an application can rollback to the last save point before an error occurred 
and continue from there. For most applications, though, you won't need to use 
save points. 
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А script that uses save points 
SAVEPOINT before invoice; 


INSERT INTO invoices 
VALUES (115, 34, 'ZXA-080', '30-AUG-08', 
14092.59, 0, 0, 3, '30=-SEP-08', NULL); 


SAVEPOINT before line iteml; 


INSERT INTO invoice line items 
VALUES (115, 1, 160, 4447.23, 'HW upgrade’); 


SAVEPOINT before line item2; 


INSERT INTO invoice line items 
VALUES (115, 2, 167, 9645.36,'OS upgrade'); 


ROLLBACK TO SAVEPOINT before line item2; 
ROLLBACK TO SAVEPOINT before line iteml; 
ROLLBACK TO SAVEPOINT before invoice; 


COMMIT; 


The response from the system 
SAVEPOINT before invoice succeeded. 

l rows inserted 

SAVEPOINT before line iteml succeeded. 
l rows inserted 

SAVEPOINT before line item2 succeeded. 
l rows inserted 

ROLLBACK TO succeeded. 

ROLLBACK TO succeeded. 

ROLLBACK TO succeeded. 

COMMIT succeeded. 


Description 


e When you use save points, you can rollback a transaction to the beginning of the transac- 
tion or to a particular save point. 


e ‘You can use the SAVEPOINT statement to create a save point with the specified name. 

e You can use the ROLLBACK TO statement to rollback a transaction to the specified save 
point. 

e Save points are useful when a single transaction contains so many SQL statements that 
rolling back the entire transaction would be inefficient. 


Figure 14-2 Ном to work with save points 
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How to work with concurrency and 
locking 


When two or more users have access to the same database, it's possible for 
them to be working with the same data at the same time. This is called 
concurrency. Although concurrency isn't a problem when two users retrieve the 
same data at the same time, it can become a problem when one user updates 
data that other users are also viewing or updating. In the topics that follow, 
you'll learn how to prevent concurrency problems. 


How concurrency and locking are related 


Figure 14-3 presents two transactions that show how Oracle handles 
concurrency by default. To start, transaction А submits an UPDATE statement 
that adds a value of 100 to the value that's stored in the credit, total column of 
the invoice that has an invoice, id value of 6. Because transaction À hasn't yet 
committed this change to the database, it retains a lock on this row. This is 
known as locking. 

At this point, if you run the SELECT statement in transaction B, the result 
set doesn't include the updated value in the credit, total column. In other words, 
the SELECT statement only reads changes that have been committed. 

In addition, the UPDATE statement in transaction B won't be able to update 
the row due to the lock that transaction А has on the row. Аз a result, it will have 
to wait for transaction A to finish before it updates the row. 

Once transaction А commits the change made by the UPDATE statement, 
the SELECT statement in transaction B will show the updated value in the 
credit total column if you run it again. In addition, when transaction А commits 
the update, it releases its lock on the row. Then, the UPDATE statement in 
transaction B finishes executing if it has been waiting. Or, if you execute the 
UPDATE statement in transaction B again, it will execute immediately. 

To experiment with concurrency, you can simulate multiple users by starting 
multiple instances of SQL Developer or SQL*Plus to execute SQL statements. 
For example, you can start two instances of SQL Developer and execute trans- 
action À in the first instance and transaction B in the second instance. Then, you 
can use the Execute Statement (F9) command to run one statement at a time. 
This allows you to slow down the execution of each script. Otherwise, if you 
use the Run Script (F5) command, the script will run so quickly that you won't 
be able to get both scripts to access the same row at the same time. 

This example shows that Oracle's default locking behavior prevents most 
concurrency problems. It also provides fast performance. However, it does allow 
a few concurrency problems that are described in figure 14-4. Although these 
concurrency problems are acceptable most of the time, you can prevent them by 
overriding Oracle's default locking behavior as shown in figure 14-5. 
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Two transactions that retrieve and then modify the data in the same row 


Transaction A 
UPDATE invoices SET credit total = credit total + 100 WHERE invoice id = 6; 


-- the SELECT statement in Transaction B won't show the updated data 
-- the UPDATE statement in Transaction B will wait for A to finish 


COMMIT; 


-- the SELECT statement in Transaction B will show the updated data 
-- the UPDATE statement in Transaction B will execute immediately 


Transaction B 


-- Use a second instance of SQL Developer or SQL*Plus 
== to execute these statements! 
-- Otherwise, they won't work as described. 


SELECT invoice id, credit total FROM invoices WHERE invoice id - 6; 
UPDATE invoices SET credit total s credit total + 200 WHERE invoice id = 6; 


COMMIT; 


Description 


e Concurrency is the ability of a system to support two or more transactions working with 
the same data at the same time. 


e Oracle can automatically prevent some concurrency problems by using locks. A lock 
stops the execution of another transaction if it conflicts with a transaction that is already 
running. 

e Concurrency is a problem only when the data is being modified. When two or more 
SELECT statements read the same data, the SELECT statements don't affect each other. 


Figure 14-3 Ном concurrency and locking are related 
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The four concurrency problems that locks can 
prevent 


Figure 14-4 describes the four most common concurrency problems. To 
start, a lost update is the problem that you've already learned about. It occurs 
when two transactions select the same row and then update the row based on the 
values originally selected. Since each transaction is unaware of the other, the 
later update overwrites the earlier update. For many applications, though, this 
type of problem rarely occurs, and it isn't serious when it does occur. 

Like lost updates, the other three problems may not adversely affect a 
database. In fact, for many applications, these problems occur infrequently. 
Then, when they do occur, they can be corrected by resubmitting the SQL 
statement that experienced the problem. On some database systems, however, 
these problems can compromise data integrity so they need to be dealt with. 

Although locks can prevent the problems listed in this figure, Oracle's 
default locking behavior only prevents dirty reads. If this level of locking isn't 
acceptable, though, you can change the default locking behavior by setting the 
transaction isolation level as shown in the next figure. 
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The four types of concurrency problems 


Lost updates 


Dirty reads 


Nonrepeatable reads 


Phantom reads 


Description 


Occur when two transactions select the same row and then update the row based on 
the values originally selected. Since each transaction is unaware of the other, the 
later update overwrites the earlier update. 


Occur when a transaction selects data that hasn't been committed by another 
transaction. For example, transaction À changes a row. Transaction B then selects 
the changed row before transaction А commits the change. If transaction А then 
rolls back the change, transaction B has selected a row that doesn't exist in the 
database. 


Occur when two SELECT statements that try to get the same data get different 
values because another transaction has updated the data in the time between the two 
statements. For example, transaction А selects a row. Transaction B then updates the 
row. When transaction À selects the same row again, the data is different. 


Occur when you perform an update or delete on a set of rows at the same time that 
another transaction is performing an insert or delete that affects one or more rows in 
that same set of rows. For example, transaction А updates the payment total for each 
invoice that has a balance due, but transaction B inserts a new, unpaid, invoice while 
transaction A is still running. After transaction A finishes, there is still an invoice 
with a balance due. 


e Inalarge system with many users, you should expect for these kinds of problems to 
occur. In general, you don't need to take any action except to anticipate the problem. In 
many cases, if the SQL statement is resubmitted, the problem goes away. 


e On some systems, if two transactions overwrite each other, the validity of the database is 
compromised and resubmitting one of the transactions won't eliminate the problem. If 
you're working on such a system, you must anticipate these concurrency problems and 
account for them in your code. 


e Ifoneofthese problems could affect the data integrity of your system, you can change 
the default locking behavior by setting the transaction isolation level as shown in the 


next figure. 


Figure 14-4 Тһе four concurrency problems that locks can prevent 
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How to set the transaction isolation level 


The simplest way to prevent concurrency problems is to change the default 
locking behavior as shown in figure 14-5. To change this behavior, you use the 
SET TRANSACTION ISOLATION LEVEL statement to set the transaction 
isolation level for the current session. 

Note, however, that Oracle doesn't support the READ UNCOMMITTED or 
REPEATABLE READ transaction isolation levels. Also, it doesn't allow you to 
use the SNAPSHOT keyword to specify an isolation level. As a result, you must 
choose between the READ COMMITTED and SERIALIZABLE levels. 

When you set the isolation level to SERIALIZABLE, each transaction is 
completely isolated from every other transaction. This prevents all four of the 
concurrency problems. 

Since the SERIALIZABLE level eliminates all concurrency problems, you 
may think that this is always the best option. However, this option requires more 
overhead to manage all of the locks so the access time for each transaction is 
increased. For some systems, this may cause significant performance problems. 
Аз a result, you typically only want to use the SERIALIZABLE isolation level 
for situations in which the four concurrency problems aren't acceptable. In most 
situations, though, the default isolation level of READ COMMITTED is 
adequate. 

In later versions of Oracle, the SERIALIZABLE isolation level may actu- 
ally be using techniques that implement the newer SNAPSHOT isolation level 
that was developed during the mid-1990s. However, these two levels prevent the 
same concurrency problems. The difference between them is the mechanism 
that Oracle uses to prevent the concurrency problems. As a result, in most cases, 
the difference is transparent to the developer. In other words, to prevent all four 
concurrency problems described in this figure, you still set the transaction 
isolation level to SERIALIZABLE. 


Chapter 14 How to manage transactions and locking 


The concurrency problems prevented by each transaction isolation level 


Isolation level 


READ UNCOMMITTED Allows 
READ COMMITTED Prevents 


REPEATABLE READ Prevents 
SERIALIZABLE Prevents 
SNAPSHOT Prevents 


Lost 
updates 
Allows 
Allows 
Prevents 
Prevents 
Prevents 


Nonrepeatable Phantom 
reads reads 
Allows 

Allows 

Prevents 

Prevents 

Prevents 


The syntax of the SET TRANSACTION ISOLATION LEVEL statement 


SET TRANSACTION ISOLATION LEVEL (READ COMMITTED | SERIALIZABLE) 


A statement that sets the transaction isolation level to SERIALIZABLE 
SET TRANSACTION ISOLATION LEVEL SERIALIZABLE; 


A statement that sets the transaction isolation level to Oracle's default 
SET TRANSACTION ISOLATION LEVEL READ COMMITTED; 


Description 


e The transaction isolation level controls the degree to which transactions are isolated 


from one another. 


e At the more restrictive isolation levels, concurrency problems are reduced or eliminated. 
However, at the least restrictive levels, performance is enhanced. 

e Oracle doesn't support the READ UNCOMMITTED or REPEATABLE READ transac- 
tion isolation levels. As a result, you must choose between the SERIALIZABLE level 
and the READ COMMITTED level (which is the default). 

e Inlater versions of Oracle, the SERIALIZABLE isolation level may actually implement 
the newer SNAPSHOT isolation level that was developed during the mid 1990s. In most 
cases, the difference is transparent to the developer. 


Figure 14-5 How to set the transaction isolation level 
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How to prevent deadlocks 


A deadlock occurs when neither of two transactions can be committed 
because each has a lock on a resource needed by the other transaction. This is 
illustrated by the banking transactions in figure 14-6. Here, transaction А 
updates the savings account first and then the checking account, while transac- 
tion B updates the checking account first and then the savings account. 

Now, suppose that the first statement in transaction À locks the savings 
account, and the first statement in transaction B locks the checking account. At 
that point, the deadlock occurs because transaction À needs the savings account 
and transaction B needs the checking account, but both are locked. Eventually, 
one of the transactions has to be rolled back so the other can proceed, and the 
loser is known as a deadlock victim. 

To prevent deadlocks, you can use the four techniques that are presented in 
this figure. First, you shouldn't leave transactions open any longer than is 
necessary. That's because the longer a transaction remains open and uncommit- 
ted, the more likely it is that another transaction will need to work with that 
same resource. 

So, when you're coding transactions, make sure to include the appropriate 
COMMIT and ROLLBACK statements. In addition, don’t code statements that 
take a long time to execute within the INSERT, UPDATE, or DELETE state- 
ments that start a transaction and the COMMIT or ROLLBACK statements that 
finish a transaction. 

Second, you shouldn't use a higher isolation level than you need. That's 
because the higher you set the isolation level, the more likely it is that two 
transactions will be unable to work with the same resource at the same time. 

Third, you should schedule transactions that modify a large number of rows 
to run when no other transactions, or only a small number of other transactions, 
will be running. That way, it's less likely that the transactions will try to change 
the same rows at the same time. 

Finally, you should consider how the SQL statements you write could cause 
a deadlock. To prevent the situation that's illustrated in this figure, for example, 
you should always update related accounts in the same sequence. 
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Don't allow transactions to remain open for very long 

e Keep transactions short. 

e Keep SELECT statements outside of the transaction except when absolutely necessary. 
e Never code requests for user input during a transaction. 


Use the lowest possible transaction isolation level 
e The READ COMMITTED level, which is the default, is usually sufficient. 


e Reserve the use of the SERIALIZABLE level for short transactions that make changes to 
data where integrity is vital. 


Make large changes when you can be assured of nearly exclusive access 


e If you need to change millions of rows in an active table, don't do so during hours of 
peak usage. 


e If possible, give yourself exclusive access to the database before making large changes. 


Consider locking when coding your transactions 


e If you need to code two or more transactions that update the same resources, code the 
updates in the same order in each transaction. 


UPDATE statements that illustrate deadlocking 
Transactlon A 


UPDATE savings SET balance - balance - :transfer amount; 
UPDATE checking SET balance = balance + :transfer amount; 
COMMIT; 

Transaction B (possible deadlock) 


UPDATE checking SET balance = balance - :transfer_amount; 
UPDATE savings SET balance = balance + :transfer amount; 
COMMIT; 


Transaction B (prevents deadlocks) 
UPDATE savings SET balance = balance + :transfer_amount; 
UPDATE checking SET balance = balance - :transfer amount; 
COMMIT; 

Description 


e А deadlock occurs when neither of two transactions can be committed because each 
transaction has a lock on a resource needed by the other transaction. 


Figure 14-6 Ном to prevent deadlocks 
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Perspective 


In this chapter, you've learned what the application developer needs to know 
about transactions, concurrency, locking, and deadlocks. In particular, this chapter 
has tried to show you what an Oracle database does automatically and what you 
need to do as an application developer. In particular, you need to make sure that 
you commit or rollback each transaction that an application issues. 


Terms 


transaction 

commit a transaction 
rollback a transaction 
save point 
concurrency 

locking 

lost update 

dirty read 
nonrepeatable read 
phantom read 
transaction isolation level 
deadlock 

deadlock victim 


Exercises 


1. Write a set of three SQL statements coded as a transaction to reflect the 
following change: United Parcel Service has been purchased by Federal 
Express Corporation and the new company is named FedUP. Rename one of 
the vendors and delete the other after updating the vendor. id column in the 
Invoices table. 


2. Write a set of two SQL statements coded as a transaction to delete the row with 


an invoice ID of 114 from the Invoices table. To do this, you must first delete 
all line items for that invoice from the Invoice Line Items table. 
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How to create stored 
procedures and functions 


In chapter 13, you learned how to include anonymous blocks of PL/SQL code 
in a SQL script. In this chapter, you'll learn how to extend this functionality by 
creating named database objects that store blocks of PL/SQL code within a 
database. These objects can be executed by any database user who has 
appropriate privileges. As you'll see, these types of objects allow you to store 
procedural logic such as data validation in a central location. In addition, they 
provide a powerful way to control how users are allowed to access the 
database. 


How to code stored procedures ................. o. 462 


How to create and call а stored procedure ioci oia ra ees 462 
How to code input and output parameters ........................ eese 466 
How to code optional parameters ........... ume ommemeeso corto rre нәни 468 
Itl. ашо сео AME I——————— 470 
Atstored' procedure that'inserts ТО... enn ap htm наада на наннан 474 
A stored procedure that drops a table .................... 6 наанаа анана 478 
Howatordropiaistored procedure: i ннан нынан 480 
How to code user-defined functions ................................ 482 
Howtoretente-and calla function ius. eo certat emus tetris 482 
А function that calculates balance QUE . uas inserti ete tarn asas 484 
Howto lr peer functione tino oder ad IER DO COR UU en hee нений 486 
How to work with packages .......................................--. 488 
How nac cocci M ———— 488 
Howitoidropia package ————9— на 490 
Advantages of pnbbBpts c e eee einer rri tte ина dt 490 
How to use SQL Developer ........................ nnns 492 
How to view and drop procedures, functions, and packages ...................... 492 
How to edit and compile procedures and functions ................................... 494 
How to grant and revoke privile Bes... oii. e ioeee c eor eere etre eee se see cuore ep aetas ced 494 
How to debug procedures and functions ............................ eere 496 


ili. 22. em 500 


462 Section 4 Тһе essential PL/SQL skills 


How to code stored procedures 


A stored procedure, which can also be referred to as a sproc or just a 
procedure, is a database object that contains a block of PL/SQL code. You can 
use stored procedures to modify the data that's stored within a database. For 
example, you can use a stored procedure to execute an INSERT, UPDATE, or 
DELETE statement. 


How to create and call a stored procedure 


Figure 15-1 shows how to use the CREATE PROCEDURE statement to 
create a stored procedure. To start, you code the CREATE keyword, followed by 
the optional OR REPLACE keywords, followed by the PROCEDURE keyword, 
followed by the name of the procedure. In this figure, for example, the state- 
ment creates a procedure named update invoices, credit total. Since this 
statement includes the OR REPLACE keywords, it creates the procedure if it 
doesn't already exist, and it replaces the procedure if it does already exist. 

Note that the name of this procedure clearly indicates that the procedure 
updates the credit total column of the invoices table. Throughout this chapter, I 
will use a similar naming convention for the other procedures. 

After the name of the procedure, you code a set of parentheses. Within the 
parentheses, you can code one or more parameters for the procedure. A param- 
eter is typically used to pass a value to the stored procedure from a calling 
program. However, a parameter can also be used to pass a value back from the 
stored procedure to the calling program. 

If a procedure accepts more than one parameter, you must use a comma to 
separate each parameter. When you declare a parameter, you code the name of 
the parameter followed by its data type. In this figure, for example, the proce- 
dure accepts two parameters. The first parameter is named 
invoice number param with a data type of VARCHAR2, and the second 
parameter is named credit total param with a data type of NUMBER. 

After the parentheses, you code the IS keyword or the AS keyword, fol- 
lowed by the PL/SQL code to be executed. In general, this PL/SQL code works 
like the anonymous blocks of PL/SQL code that you learned how to code in 
chapter 13. However, if you need to declare variables, you don't use the DE- 
CLARE keyword to identify the DECLARE section. Instead, you just declare 
the variables immediately after the IS or AS keyword but before the BEGIN 
keyword. Although this isn't illustrated in this figure, it is shown in the next 
figure. 

When you run the CREATE PROCEDURE statement, Oracle compiles the 
PL/SQL code for the procedure and stores the compiled code in the database. 
As part of this process, Oracle's compiler checks the syntax of the code within 
the procedure. If you've made a coding error, the system responds with an 
appropriate message and the procedure isn't created. 
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The syntax of the CREATE PROCEDURE statement 


CREATE [OR REPLACE] PROCEDURE procedure name 
[( 
parameter name 1 data type 
[, parameter name 2 data type]... 
)] 
{Is | as} 
pl sql block 


А script that creates a stored procedure that updates a table 


CREATE OR REPLACE PROCEDURE update invoices credit total 
( 
invoice number param VARCHAR2, 
credit total param NUMBER 
) 
АВ 
ВЕСІМ 
UPDATE invoices 
SET credit total s credit total param 
WHERE invoice number = invoice number param; 


COMMIT; 
EXCEPTION 
WHEN OTHERS THEN 
ROLLBACK; 
END; 
/ 


Description 


You use the CREATE PROCEDURE statement to create a stored procedure. А stored 
procedure is an executable database object that contains a block of PL/SQL code. À 
stored procedure can also be called a sproc or a procedure. 

Stored procedures are compiled before they are stored in the database. 

You can use parameters to pass one or more values from the calling program to the 
stored procedure or from the procedure to the calling program. For more information on 
working with parameters, see figures 15-2 and 15-3. 

To declare a parameter within a stored procedure, you code the name of the parameter 


followed by its data type. If you declare two or more parameters, you separate the 
parameters with commas. 


Figure 15-1 How to create and call a stored procedure (part 1 of 2) 
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You can execute, or call, a stored procedure by using the CALL statement. 
In part 2 of this figure, for example, the CALL statement calls the procedure 
that's created in part 1. This statement passes one value for each of the param- 
eters that are defined by the procedure. Here, the first parameter is a 
VARCHAR? literal that specifies the invoice number, and the second parameter 
is a NUMBER literal that identifies the new amount for the credit total. 

When you use the CALL statement, you must pass parameters by position. 
In other words, you must code the parameters in the same order as they are 
coded in the CREATE PROCEDURE statement. This is the most common way 
to call stored procedures that have a short list of parameters. 

If you are coding a script that calls a procedure, you don't code the CALL 
keyword. Instead, you just code the name of the procedure and its parameters. 
In this figure, for example, the first script performs the same task as the CALL 
statement. 

When you call a procedure from a script, you can also pass parameters by 
name. To do that, you include the names of the parameters as defined in the 
CREATE PROCEDURE statement, followed by the association operator (=>), 
followed by the value that's passed. When you use this technique, you can list 
parameters in any order. This is illustrated by the second script in this figure. If 
a procedure has many parameters, passing parameters by name is often easier 
and less error-prone than passing parameters by position. 

In chapter 12, you learned how to grant INSERT, UPDATE, and DELETE 
privileges to specific users. However, if you want to have more fine-grained 
control over the privileges that you grant to users, you can create stored proce- 
dures that perform all of the types of data manipulation that you want to allow 
within your database. Then, you can grant privileges to execute these stored 
procedures. For systems where security is critical, this can be an excellent way 
to prevent both accidental errors and malicious damage to your data. 
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А statement that calls a stored procedure 
CALL update invoices credit total('367447', 300); 


A script that calls a stored procedure 


BEGIN 

update invoices credit total('367447', 300); 
END; 
/ 


А script that passes parameters by name 


BEGIN 
update invoices credit total( 
credit total params»300, 
invoice number param=>'367447'); 
END; 
/ 


Description 


e ‘You can use the CALL statement to call a procedure. When a procedure accepts param- 
eters, you pass them to the procedure by coding them within the parentheses that follow 
the procedure name, and by separating each parameter with a comma. 


e When you use a CALL statement to call a procedure, you pass parameters by position. 
This means that you list them in the same order as they appear in the CREATE PROCE- 
DURE statement. 


e When you use a script to call a procedure, you can pass parameters by position or by 
name. When you pass parameters by name, you code the name of each parameter, 
followed by the association operator (=>), followed by the value. In this case, the 
parameters don't have to be in the same order as they appear in the CREATE PROCE- 
DURE statement. 


Figure 15-1 How to create and call a stored procedure (part 2 of 2) 


465 


466 Section 4 Тһе essential PL/SQL skills 


How to code input and output parameters 


Figure 15-2 shows how to code input and output parameters for a stored 
procedure. Stored procedures provide for three different types of parameters: 
input parameters, output parameters, and input/output parameters. 

An input parameter is passed to the stored procedure from the calling 
program. You can explicitly identify an input parameter by coding the IN 
keyword after the name of the parameter. In this figure, for example, the first 
two parameters are identified as input parameters. However, if you omit this 
keyword, the parameter is assumed to be an input parameter. In figure 15-1, for 
example, both parameters are input parameters. 

Within a procedure, you can use input parameters like variables. However, 
you can't change the value of the parameter. In this figure, for example, the 
procedure uses the first parameter within an UPDATE statement to specify the 
invoice number for the invoice row to be updated. Then, it uses this parameter 
within a SELECT statement to get a count of the number of rows that have been 
updated. 

Ап output parameter is returned to the calling program from the stored 
procedure. To code an output parameter, you must explicitly identify the param- 
eter by coding the OUT keyword after the name of the parameter. In this figure, 
for example, the third parameter is an output parameter. If the UPDATE state- 
ment executes successfully, the SELECT statement stores the count of the rows 
that were updated in this parameter. Since the invoice number should be unique, 
this should store a value of 1 in the output parameter. On the other hand, if the 
UPDATE statement doesn't execute successfully, the SELECT statement in the 
EXCEPTION section of the procedure stores a value of 0 in the output param- 
eter. Either way, the value of the output parameter is returned to the calling 
program when the procedure finishes. 

To show how a calling program works, this figure includes a script that calls 
the procedure. Here, initial values are supplied for the two input parameters, and 
a variable named row. count is supplied for the output parameter. After the 
procedure executes, the value of the output parameter is stored in the variable 
named row. count. Then, the calling program can use this variable to check how 
many rows have been updated. In this figure, for example, the script prints the 
value of this variable to the console. However, it could also use an IF statement 
to check the value of the variable and perform an appropriate action. 

An input/output parameter stores an initial value that's passed in from the 
calling program like an input parameter. However, the procedure can change 
this value and return it to a calling program like an output parameter. To identify 
an input/output parameter, you must code the IN OUT keywords after the name 
of the parameter. Although this can be useful in some situations, it can also be 
confusing. Ás a result, it often makes sense to avoid the use of input/output 
parameters. 
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The syntax for declaring input and output parameters 


parameter name 1 [IN|OUT|IN OUT] data type 


А stored procedure that uses input and output parameters 


CREATE OR REPLACE PROCEDURE update invoices credit total 
( 
invoice number param IN VARCHAR2, 
credit total param IN NUMBER, 
update count OUT INTEGER 
) 
AS 
BEGIN 
UPDATE invoices 
SET credit total = credit total param 
WHERE invoice number = invoice number param; 


SELECT COUNT(*) 

INTO update count 

FROM invoices 

WHERE invoice number = invoice number param; 


COMMIT; 
EXCEPTION 
WHEN OTHERS THEN 
SELECT 0 INTO update_count FROM dual; 
ROLLBACK; 
END; 
/ 


A script that calls the stored procedure and uses the output parameter 


SET SERVEROUTPUT ON; 

DECLARE 
row count INTEGER; 

BEGIN 
update invoices credit total('367447', 200, row count); 
DBMS OUTPUT.PUT LINE('row count: ' || row count); 

END; 

/ 


Description 


Input parameters accept values that are passed from the calling program. These values 
cannot be changed by the body of the stored procedure. By default, parameters are 
defined as input parameters. As a result, the IN keyword is optional for identifying input 
parameters. 


Output parameters store values that are passed back to the calling program. These values 
must be set by the body of the stored procedure. To identify an output parameter, you 
must code the OUT keyword. To use an output parameter, the calling program must 
declare a variable to store its value, and it must include this variable in the parameter list. 
Input/output parameters can store an initial value that's passed from the calling program. 


However, the body of the stored procedure can change this parameter. To identify an 
input/output parameter, you must code the IN OUT keywords. 


Figure 15-2 How to code input and output parameters 
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How to code optional parameters 


Figure 15-3 shows how to code an optional parameter. When you call a 
procedure that has optional parameters, you can omit any of its optional param- 
eters. In this figure, for example, the second parameter is an optional parameter. 
As a result, when you call this procedure, you can omit the second parameter. In 
that case, the credit total for the specified invoice is set to a default value of 100. 
Or, you can pass both parameters. In that case, the credit total for the specified 
invoice is set to the value of the second parameter. 

To start, it usually makes sense to code all optional parameters at the end of 
the parameter list. Then, you use the DEFAULT keyword to specify a default 
value for each of the parameters. In this figure, for example, the DEFAULT 
keyword specifies a default value of 100 for the second parameter. 

The first CALL statement in this figure supplies both parameters. As a 
result, the credit total for the invoice 1s set to 200. However, the second CALL 
statement in this figure omits the second parameter. Аз a result, the credit total 
for the invoice is set to the default value of 100. 

In this figure, it's easy to supply a default value for the optional parameter. 
However, you may sometimes need to write code that sets a value of a param- 
eter depending on the values of the other parameters. In that case, you can set 
the default value for the optional parameter to NULL. Then, within the body of 
the procedure, you can write an IP statement that tests for the NULL value and 
executes the appropriate code. For an example of this technique, you can check 
the code in figure 15-5 that sets the default values for the terms id and 
invoice due date columns. 
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The syntax for declaring an optional parameter 
parameter name 1 data type [DEFAULT default value] 


A CREATE PROCEDURE statement that uses an optional parameter 


CREATE OR REPLACE PROCEDURE update invoices credit total 
( 
invoice number param VARCHAR2, 
credit total param NUMBER DEFAULT 100 
) 
AS 
BEGIN 
UPDATE invoices 
SET credit total s credit total param 
WHERE invoice number - invoice number param; 


COMMIT; 
EXCEPTION 
WHEN OTHERS THEN 
ROLLBACK; 
END; 
/ 


А statement that calls the stored procedure 
CALL update invoices credit total('367447', 200); 


Another statement that calls the stored procedure 
CALL update invoices credit total(!'367447!); 


Description 


e Optional parameters are parameters that don't require that a value be passed from the 
calling program. To declare an optional parameter, you use the DEFAULT keyword to 
assign it a default value. 

e It’s a good programming practice to code your CREATE PROCEDURE statements so 
that they list required parameters first, followed by optional parameters. 


Figure 15-3 Ном to code optional parameters 
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How to raise errors 


Within a stored procedure, it's generally considered a good practice to 
prevent errors by checking the parameters before they're used to make sure 
they're valid. This is often referred to as data validation. Then, if the data isn't 
valid, you can execute code that makes it valid, or you can raise an error, which 
returns an error to the calling program. 

Part 1 of figure 15-4 shows how to raise an error by raising one of the 
predefined exceptions that are available from Oracle. To do that, you code the 
RAISE statement followed by the name of the predefined exception. In this 
figure, for example, the IF statement checks whether the value of the second 
parameter is less than zero. If so, it raises the predefined VALUE, ERROR 
exception that's described in chapter 13. 

If the calling program doesn't catch this exception, the system displays an 
error. In this figure, for example, the CALL statement passes a negative value to 
the second parameter, which causes the VALUE, ERROR exception to be 
raised. As a result, the system displays an error message that indicates that a 
value error has occurred. 

However, if the calling program catches this exception, it can include code 
that handles the exception. In this figure, for example, the script that calls the 
procedure includes an EXCEPTION section that handles this exception by 
printing a message to the console that says, "A VALUE, ERROR occurred." If 
necessary, this message could be improved to be more user-friendly. In addition, 
the EXCEPTION section handles all other exceptions by printing a message to 
the console that says, "An unexpected error occurred." This shows how a calling 
program can handle each specific exception differently. 


Chapter 15 How to create stored procedures and functions 


The syntax of the RAISE statement 


RAISE exception name 


A stored procedure that raises a predefined exception 


CREATE OR REPLACE PROCEDURE update invoices credit total 
( 

invoice number param VARCHAR2, 

credit total param NUMBER 
) 
AS 
BEGIN 

IF credit total param « 0 THEN 

RAISE VALUE ERROR; 
END IF; 


UPDATE invoices 
SET credit total = credit total param 
WHERE invoice number - invoice number param; 


COMMIT; 
END) 
/ 


A statement that calls the procedure 
CALL update invoices credit total('367447', -100); 


The response from the system 


Error report: 
SQL Error: ORA-06502: PL/SQL: numeric or value error 
ORA-06512: at "AP.UPDATE INVOICES CREDIT TOTAL", line 9 


A script that calls the procedure 
SET SERVEROUTPUT ON; 


BEGIN 
update invoices credit total('367447', -100); 
EXCEPTION 
WHEN VALUE ERROR THEN 
DBMS OUTPUT.PUT LINE('A VALUE ERROR occurred.!); 
WHEN OTHERS THEN 
DBMS OUTPUT.PUT LINE('An unknown exception occurred.') ; 
END; 
/ 


The response from the system 
A VALUE ERROR occurred. 


Figure 15-4 Ном to raise errors (part 1 of 2) 
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Part 2 of figure 15-4 shows how to raise an error by raising an application 
error, which is an error that you create. To do that, you call the 
RAISE APPLICATION ERROR procedure that's available from Oracle. 
Within the parentheses for this procedure, the first parameter specifies the error 
number, and the second parameter specifies the error message. Here, the error 
number parameter must be between -20000 and -20999. 

When you use the RAISE APPLICATION ERROR procedure, you can 
specify more helpful and user-friendly messages than the generic messages that 
are available from the predefined exceptions. In this figure, for example, the 
error message says, "Credit total may not be negative." At this point, the user or 
programmer of the calling application should be able to identify and fix the 
problem. 

However, when you raise an application error, the calling program can't use 
specific exception handlers. Instead, the calling program must use the WHEN 
OTHERS THEN clause to catch all application errors. In most cases, that's 
acceptable. If it isn't, you need to define your own user-defined exceptions. For 
information about doing that, you can refer to the Oracle Database PL/SQL 
Language Reference. 
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The syntax of the RAISE APPLICATION ERROR procedure 


RAISE APPLICATION ERROR(error number, error message); 


А statement that raises an application error 


RAISE APPLICATION ERROR(-20001, 'Credit total may not be negative.'); 


The response from the system if the error is not caught 


Error report: 
SQL Error: ORA-20001: Credit total may not be negative. 
ORA-06512: at "AP.UPDATE INVOICES CREDIT TOTAL", line 10 


А script that catches an application error 


BEGIN 
update invoices credit total('367447', -100); 
EXCEPTION 
WHEN VALUE_ERROR THEN 
DBMS OUTPUT.PUT LINE('A VALUE ERROR occurred.!); 
WHEN OTHERS THEN 
DBMS OUTPUT.PUT LINE('An unknown exception occurred.'); 
END; 
/ 


The response from the system 
An unknown exception occurred. 


Description 


It's generally considered a good practice to validate the data within a stored procedure 
before using the data. This is referred to as data validation. 


The RAISE statement raises a predefined exception such as the exceptions described in 
chapter 13. 


The RAISE, APPLICATION ERROR procedure raises an application error with the 
specified error number and message. When you use this statement, the error number 
parameter must be between -20000 and -20999. 


Raised errors are returned to the caller like errors that are raised by the database engine. 
You can use the WHEN clause to catch predefined exceptions. 
You can use the WHEN OTHERS THEN clause to catch application errors. 


Figure 15-4 Ном to raise errors (part 2 of 2) 
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А stored procedure that inserts a row 


Figure 15-5 presents a stored procedure that inserts new rows into the 
invoices table. This should give you a better idea of how you can use stored 
procedures. 

This procedure uses nine parameters that correspond to nine of the columns 
in the invoices table. АП of these parameters are input parameters, and each 
parameter is assigned the same data type as the matching column in the invoices 
table. Аз a result, if the calling program passes a value that can't be converted to 
the proper data type, an error will be raised when the procedure is called. 

Note that none of these parameters corresponds with the invoice id column. 
That's because the body of the procedure uses a sequence to provide a value for 
this column, which is usually what you want. 

Note also that the last five parameters are optional parameters that have 
been assigned default values. Of these, the last three parameters have been 
assigned a default value of NULL. 

After the AS keyword, the procedure begins by declaring four variables. Of 
these variables, the first three have data types that correspond with columns in 
the invoices table. However, the fourth one uses the INTEGER data type to store 
the number of days before the invoice is due. 

Note that all of the variables have a suffix of " var" while all of the param- 
eters defined earlier have a suffix of " param". This makes it easy to tell the 
difference between the parameters that are passed to the procedure from the 
calling program and the variables that are used within the procedure. 

After the BEGIN keyword, a SELECT statement stores the next value in the 
sequence for the invoice id column in a variable. To do that, this SELECT 
statement selects the value that's returned by the NEXTVAL pseudo column of 
the sequence into the variable named invoice id var. 

After the SELECT statement, the procedure begins by using a simple IF 
statement to check the value of the parameter for the invoice, total column to 
see if it is less than zero. If so, the procedure uses the RAISE statement to raise 
the predefined VALUE ERROR exception. This statement exits the stored 
procedure and returns the exception to the calling program. Although this figure 
only codes a single IF statement, it's common to code a series of IF statements 
like this one to provide more extensive data validation. 

After the SELECT statement, an IF statement checks the optional parameter 
for the terms, id column to see if it contains a NULL value. If so, a SELECT 
statement sets the variable that corresponds to the parameter to an appropriate 
value. Here, for example, the variable for the terms id column is set to the value 
that's stored in the default terms, id column of the vendors table. Otherwise, 
this code sets the corresponding variable to the value of the parameter. 

In other words, if the parameter contains a NULL value, some code is 
executed to set it to an appropriate value. Or, if the parameter contains a non- 
null value, the code uses that value. 
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А stored procedure that validates the data in a new invoice 


CREATE OR REPLACE PROCEDURE insert invoice 
( 


vendor id param invoices.vendor id&TYPE, 
invoice number param invoices.invoice number%TYPE, 
invoice date param invoices.invoice date&*TYPE, 
invoice total param invoices.invoice_total%TYPE, 
payment total param invoices.payment total&TYPE DEFAULT 0, 
credit total param invoices.credit total*TYPE DEFAULT 0, 
terms id param involces.terms id&TYPE DEFAULT NULL, 
invoice due date param invoices.invoice due date*TYPE DEFAULT NULL, 
payment date param invoices.payment date*TYPE DEFAULT NULL 
) 
AS 
invoice id var invoices.invoice_id*TYPE; 
terms id var involces.terms id*TYPE; 
invoice due date var | invoices.invoice dateXTYPE; 
terms due days var INTEGER; 
BEGIN 


IF invoice total param « 0 THEN 
RAISE VALUE ERROR; 
END IF; 


SELECT invoice id seq.NEXTVAL INTO invoice id var FROM dual; 


IF terms id param IS NULL THEN 

SELECT default terms id INTO terms id var 

FROM vendors WHERE vendor id - vendor id param; 
ELSE 

terms id var := terms id param; 
END IF; 


IF invoice due date param IS NULL THEN 
SELECT terms due days INTO terms due days var 
FROM terms WHERE terms id - terms id var; 
invoice due date var := invoice date param + terms due days var; 
ELSE 
invoice due date var := invoice due date param; 
END IF; 


INSERT INTO invoices 

VALUES (invoice id var, 
vendor id param, invoice number param, invoice date param, 
invoice total param, payment total param, credit total param, 
terms id var, invoice due date var, payment date param); 


Figure 15-5 А stored procedure that inserts a row (part 1 of 2) 
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At this point, another IF statement checks the optional parameter for the 
invoice due date column. Since this works similarly to the previous IF state- 
ment, you shouldn't have much trouble understanding how it works. To start, it 
checks the parameter to see if it contains a NULL value. If so, a SELECT 
statement uses the value of the terms id var to get the number of days until the 
invoice is due from the terms table, and it stores this value in the variable named 
terms due days var. Then, it calculates a due date for the invoice by adding the 
number of days until the invoice is due to the invoice date. Otherwise, this code 
sets the corresponding variable to the value that's stored in the parameter. 

After the values have been set for the variables for the invoice id, terms іа, 
and invoice, due date columns, this procedure executes an INSERT statement. 
If this statement executes successfully, the row is inserted into the database. 
However, since the line items for the invoice haven't yet been inserted, this 
stored procedure does not use a COMMIT statement to commit changes to the 
database. As a result, the program that's calling this statement must issue the 
COMMIT statement. Typically, this would happen after the application program 
uses a similar stored procedure to insert the line items for the invoice. That way, 
the line items and the invoice are part of the same transaction. 

In most cases, a stored procedure like this is called from an application 
program. However, to test a procedure before it's used by an application pro- 
gram, you can use CALL statements like the ones in this figure. 

The first three CALL statements provide valid values that successfully 
insert a new row. Of these three statements, the first supplies all of the param- 
eters for the procedure. The second supplies the first eight parameters, but not 
the ninth. And the third only supplies the first four parameters. This shows that 
the first four parameters are the only parameters that are required by the proce- 
dure. That's because the procedure will either use the default values coded after 
the parameter, or it will set a default value within the body of the procedure. 

The fourth CALL statement provides a negative number for the invoice total 
parameter. As a result, this CALL statement will cause the stored procedure to 
raise the predefined VALUE ERROR exception. Since the CALL statement 
doesn't handle this exception, this causes an error message to be displayed. 
However, if you call the stored procedure from a block of PL/SQL code or from 
an application, you can include code that handles the exception. 
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Three statements that call the stored procedure 


CALL insert invoice(34, 'ZXA-080', '30-AUG-08', 14092.59, 
0, 0, 3, '30-SEP-08', NULL); 


CALL insert invoice(34, 'ZXA-080', !'30-AUG-08', 14092.59, 
0, 0, 3, '30-SEP-08'); 


CALL insert invoice(34, 'ZXA-080', '30-AUG-08', 14092.59); 


The response from the system for a successful insert 
CALL insert invoice(34, succeeded. 


А statement that raises an error 


CALL insert invoice(34, 'ZXA-080', !'30-AUG-08', -14092.59); 


The response from the system when a validation error occurs 


Error report: 
SQL Error: ORA-06502: PL/SQL: numeric or value error 
ORA-06512: at "AP.INSERT INVOICE", line 20 


Description 


If the data for each of the columns of the row is valid, the procedure executes an IN- 
SERT statement to insert the row. Otherwise, the database engine raises an error and 
exits the procedure. 


If an application program calls this procedure, it can handle any errors that are raised by 
the procedure or by the database engine. 


Since this procedure doesn't include a COMMIT statement, the application program that 
calls this procedure must commit the change to the database. Ideally, an application 
program would commit the invoice data to the database after the line items for the 
invoice have also been inserted. 


Figure 15-5 А stored procedure that inserts а row (part 2 of 2) 
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А stored procedure that drops a table 


Figure 15-6 presents a simple but useful stored procedure that drops a table. 
This shows that you can code a procedure to execute DDL statements such as 
the DROP TABLE statement. 

To start, this procedure accepts a single parameter that specifies the name of 
the table. Then, it uses the EXECUTE IMMEDIATE statement to execute a 
string that contains the DROP TABLE keywords followed by the parameter that 
stores the name of the table. As a result, if a table with that name exists, it is 
dropped from the database. 

However, if a table with that name doesn't exist within the database, the 
EXECUTE IMMEDIATE statement will cause an exception to be raised. Then, 
execution will jump into the EXCEPTION section, and the code in this section 
will handle the exception. This code handles all exceptions by using the NULL 
statement to do nothing, which suppresses any error messages. Аз a result, this 
procedure can be useful for database creation scripts that begin by dropping 
tables before creating tables with the same names such as the script that you 
used to create the tables for the AP user/schema. 
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А stored procedure that drops a table 


CREATE OR REPLACE PROCEDURE drop table 
( 

table name VARCHAR2 
) 
AS 
BEGIN 

EXECUTE IMMEDIATE 'DROP TABLE ' || table name; 
EXCEPTION 

WHEN OTHERS THEN 

NULL; 

END; 
/ 


А statement that calls the stored procedure 
CALL drop table('testl!); 


The response from the system 
CALL drop table('testl') succeeded. 


Description 


e ‘You can code a stored procedure to execute DDL statements such as the DROP TABLE 
statement. 


Figure 15-6 A stored procedure that drops a table 
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How to drop a stored procedure 


Figure 15-7 shows how to drop a stored procedure. To do that, you can code 
the DROP PROCEDURE keywords followed by the name of the procedure. In 
this figure, the first example uses the CREATE PROCEDURE statement to 
create a procedure named clear invoices credit total. Then, the second example 
uses the DROP PROCEDURE statement to drop that procedure. 

If you drop a table, sequence, or view used by a procedure, you should be 
sure to drop the procedure as well. If you don't, the procedure can still be called 
by any user or program that has been granted the appropriate privileges. Then, 
an error will occur because the table, sequence, or view that the procedure 
depends on no longer exists. 
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The syntax of the DROP PROCEDURE statement 


DROP PROCEDURE procedure name 


A statement that creates a stored procedure 


CREATE PROCEDURE clear invoices credit total 
( 
invoice number param  VARCHAR2 
) 
AS 
BEGIN 
UPDATE invoices 
SET credit total a 0 
WHERE invoice number - invoice number param; 


COMMIT; 


END; 
/ 


A statement that drops a stored procedure 
DROP PROCEDURE clear invoices credit total 


Description 
e То drop a stored procedure from the database, use the DROP PROCEDURE statement. 


Figure 15-7 Ном to drop a stored procedure 
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How to code user-defined functions 


In chapter 8, you learned about some built-in functions that are provided by 
Oracle. Now, you'll learn how to create your own functions. These functions are 
referred to as user-defined functions (UDFs), stored functions, or just functions. 

In many ways, the code for creating a function works similarly to the code 
for creating a stored procedure. However, there are two primary differences 
between stored procedures and functions. First, a function always returns a 
value or a table. Second, a function can't make changes to the database such as 
executing an INSERT, UPDATE, or DELETE statement. 


How to create and call a function 


Figure 15-8 shows how to create a scalar function, which is a function that 
returns a single value. That's the type of function that you'll learn to create in 
this chapter. 

To start, you code the CREATE FUNCTION statement, followed by the 
name of the function. If you want to automatically drop any existing function 
that has the same name, you can include the optional OR REPLACE keywords. 
In this figure, the example shows how to create a function named get. vendor. id. 

After the name of the function, you code a set of parentheses. Within the 
parentheses, you code the parameters for the function. In this figure, for ex- 
ample, the function only contains a single parameter of the VARCHAR2 type 
that’s named vendor name param. Since this works similarly to declaring 
parameters for a stored procedure, you shouldn't have much trouble understand- 
ing how this works. The main difference is that it rarely makes sense to use 
output parameters for a function. As a result, functions almost always use input 
parameters as shown by the examples in this chapter. 

After the parentheses, you code the RETURN keyword, followed by the 
data type that's returned by the function. In this figure, the example returns a 
value of the NUMBER type. 

After the declaration of the return type, you code the IS or AS keyword to 
signal that you are about to begin coding the PL/SQL code for the function. In 
this figure, the PL/SQL code begins by declaring a variable of the NUMBER 
type named vendor. id var. 

After the BEGIN keyword, this function uses a SELECT statement to get 
the vendor ID value that corresponds with the vendor name parameter and to 
store this value in the vendor ID variable. Then, it uses the RETURN statement 
to return this value to the calling program. 

To call a user-defined function, you can use it in an expression as if it's one 
of Oracle's built-in functions. Then, the value that's returned by the function is 
substituted for the function. In this figure, the last example shows how to use 
the get vendor id function within a SELECT statement to return the vendor ID 
value for the vendor with the name of “IBM”. 
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The syntax for creating a function 


CREATE [OR REPLACE] FUNCTION function name 
[( 
parameter name 1 data type 
[, parameter name 2 data typel... 
)] 
RETURN data type 
(rs | as} 
pl sql block 


А function that returns the vendor ID that matches a vendor's name 


CREATE OR REPLACE FUNCTION get vendor id 
( 

vendor name param VARCHAR2 
) 
RETURN NUMBER 
AS 

vendor id var NUMBER; 
BEGIN 

SELECT vendor id 

INTO vendor id var 

FROM vendors 

WHERE vendor name s vendor name param; 


RETURN vendor id var; 
END; 
/ 


А SELECT statement that uses the function 


SELECT invoice number, invoice total 
FROM invoices 
WHERE vendor id = get vendor id('IBM') 


The response from the system 


INVOICE NUMBER | INVOICE TOTAL 
1 @Р58872 41654 


2 3545443 1083.58 


Description 


A user-defined function (UDF), which can also be called a stored function or just a 
function, is an executable database object that contains a block of PL/SQL code. 


А scalar-valued function returns a single value of any data type. 


A function can accept input parameters that work like the input parameters for a stored 
procedure. 

А function always returns a value. You use the RETURN keyword to specify the value 
that's returned by the function. 


A function can't make changes to the database such as executing an INSERT, UPDATE, 
or DELETE statement. 


Figure 15-8 Ном to create and call a function 
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If you find yourself repeatedly coding the same expression within a SQL 
statement, you may want to create a scalar-valued function for the expression. 
Then, you can use that function in place of the expression, which can save you 
coding time and make your code easier to maintain. When you start work on a 
new database, for example, you may want to create a set of useful UDFs. 


А function that calculates balance due 


Figure 15-9 shows a function that calculates the balance due for an invoice. 
To do that, this function accepts a parameter that contains an invoice ID value. 
Then, the body of the function calculates the balance due, stores the result of the 
calculation in a variable named balance due var, and uses the RETURN 
statement to return that value. 

The SELECT statement in this figure uses this function to return the bal- 
ance due for the specified invoice ID value. Note that calling the function like 
this: 

get balance due(invoice id) AS balance due 
has the same effect as performing a calculation like this: 

invoice total - payment total - credit total AS balance due 


However, there are two advantages to using the function. First, as you can see, 
the code is shorter, which makes it easier to type. Second, the code for calculat- 
ing the balance due is stored in a single location. As a result, if the formula for 
calculating the balance due later changes, you only need to change it in one 
location. 
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А function that calculates balance due 


CREATE OR REPLACE FUNCTION get balance due 
( 
invoice id param NUMBER 
) 
RETURN NUMBER 
AS 
balance due var NUMBER; 
BEGIN 
SELECT invoice total - payment total - credit total AS balance due 
INTO balance due var 
FROM invoices 
WHERE invoice id = invoice id param; 


RETURN balance due var; 
END; 
/ 


А statement that calls the function 


SELECT vendor id, invoice number, 

get balance due(invoice id) AS balance due 
FROM invoices 
WHERE vendor id = 37; 


The response from the system 


vENDOR ID |8 INVOICE NUMBER |) BALANCE_DUE 
37 547479217 


37 547480102 
37 547481328 


Description 


e This function accepts a single parameter that specifies the ID for an invoice, and it 
returns the balance due for that invoice. 


Figure 15-9 А function that calculates balance due 
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How to drop a function 


Figure 15-10 shows how to drop a user-defined function. To do that, you 
code the DROP FUNCTION keyword followed by the name of the procedure. 
This is illustrated by the third example in this figure. 

To start, though, the first example presents another function named 
get sum, balance due. This function uses the aggregate SUM function de- 
scribed in chapter 5 to return the sum of the total balance due for the specified 
vendor. What's interesting here is that this function calls the get balance, due 
function presented in the previous figure. In other words, this function “de- 
pends" on the get, balance, due function. 

Then, the second example shows a SELECT statement that uses the 
get. sum, balance, due function. This statement gets the total balance due for the 
vendor with an ID of 37. 

Like stored procedures, functions depend on underlying database objects 
such as tables, sequences, and views as well as other procedures or functions. 
Then, if you drop a database object that a function depends on, the function 
won't work properly. As a result, you should avoid dropping any database 
objects that depend on other database objects. For example, you shouldn't use 
the DROP FUNCTION object to drop the get balance due function since the 
get sum, balance due function depends on it. 


Chapter 15 Ноу to create stored procedures and functions 


The syntax of the DROP FUNCTION statement 


DROP FUNCTION function name 


А statement that creates a function 


CREATE FUNCTION get sum balance due 
( 
vendor id param NUMBER 
) 
RETURN NUMBER 
AS 
sum balance due var NUMBER; 
BEGIN 
SELECT SUM(get balance due(invoice id)) AS sum balance due 
INTO sum balance due var 
FROM invoices 
WHERE vendor id s vendor id param; 


RETURN выш balance due var; 
END; 
/ 


А statement that calls the function 


SELECT vendor id, invoice number, 

get balance due(invoice id) AS balance due, 

get Bum balance due(vendor id) AS sum balance due 
FROM invoices 
WHERE vendor id = 37; 


The response from the system 


VENDOR D INVOICE_MUMBER |8 BALANCE DUE | sUM BALANCE, DUE 
118 


1 37 547479217 564 * 
2 37 547460102 224 564 
3 3? 547481328 224 564 


A statement that drops a function 
DROP FUNCTION get sum balance due; 


Description 


e То delete a user-defined function from the database, use the DROP FUNCTION statement. 


Notes about the function in this figure 


e The function in this figure uses the get balance due function that's presented in the 
previous figure. Аз a result, if you drop the get balance due function, the function in 
this figure won't work. 


Figure 15-10 How to drop a function 
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How to work with packages 


A package is a container that organizes and groups related stored proce- 
dures and user-defined functions. In chapter 13, for example, you learned how 
to use the built-in package named DBMS, OUTPUT to print data to the output 
window. Now, you'll learn how to store your own procedures and functions 
within a package. 

The Oracle documentation occasionally uses the term subprogram as a 
generic term that can refer to a procedure or a function. This makes sense if you 
recognize that procedures and functions are essentially small programs. 


How to create a package 


Figure 15-11 shows how to create a package. To start, you use the CREATE 
PACKAGE statement to create the specification for the package. A package 
specification lists the names and parameters for all of the procedures and 
functions that are contained within the package. In addition, it specifies the 
return types for its functions. In this figure, for instance, the first example 
specifies that the package named murach contains one procedure and one 
function. It specifies two parameters for the procedure. It specifies one param- 
eter for the function. And it specifies the return type for the function. 

Once you've created the specification for a package, you can use the 
CREATE PACKAGE BODY statement to create the body for the package. А 
package body contains the code for its procedures and functions. Within the 
body, the names, parameters, and return types must match the names, param- 
eters, and return types in the specification. In this figure, you can see that the 
package specification matches the package body. However, if the specification 
doesn't match the body, an error is displayed when Oracle attempts to compile 
the package. 
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The syntax for defining the specification for a package 


CREATE [OR REPLACE] PACKAGE package name {IS | AS) 
prodedure or function Bpecification 1; 
[prodedure or function specification 2;]... 

END [package name]; 


Code that defines the specification for a package named murach 
CREATE OR REPLACE PACKAGE murach AS 


PROCEDURE update invoices credit total 
(invoice number param VARCHAR2, credit total param NUMBER); 


FUNCTION get vendor id 
(vendor name param VARCHAR2) 
RETURN NUMBER; 


END murach; 
/ 


The syntax for defining the body for a package 


CREATE [OR REPLACE] PACKAGE BODY package name {IS | AS) 
prodedure or function body 1; 
[prodedure or function body 2;]... 

END [package name]; 

/ 


Code that defines the body for a package named murach 
CREATE OR REPLACE PACKAGE BODY murach AS 


PROCEDURE update invoices credit total 
( 
invoice number param  VARCHAR2, 
credit total param NUMBER 
) 
AS 
BEGIN 
UPDATE invoices 
SET credit total = credit total param 
WHERE invoice number = invoice number param; 


COMMIT; 
EXCEPTION 
WHEN OTHERS THEN 
ROLLBACK; 
END; 


Figure 15-11 How to create and drop packages (part 1 of 2) 
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In general, you can use the techniques you learned earlier in this chapter to 
call a procedure or function that's stored in package. However, you must preface 
the name of the procedure or function with the name of the package. In part 2 of 
this figure, for example, the CALL statement calls the procedure that's stored in 
the murach package, and the SELECT statement uses the function that's stored 
in the murach package. Note that storing this procedure and function in a 
package prevents a naming conflict with a procedure and function of the same 
name that aren't stored in a package. 

In this figure, the package contains just one short procedure and one short 
function. In practice, though, a package might include dozens of procedures and 
functions and some of them might be far more complex than the ones in this 
chapter. А more realistic package might also include global variables that can be 
shared between procedures and functions. 


How to drop a package 


As you would expect, you use the DROP PACKAGE statement to drop a 
package. When you use this statement, the specification and the body for the 
package are dropped. In this figure, for example, the first DROP statement 
drops the specification and the body for the package named murach. 

In some cases, though, you may only want to drop the body for the package. 
That way, other procedures or functions that reference the package specification 
can still be compiled. In that case, you can use the DROP PACKAGE BODY 
statement to drop only the body of the package. 


Advantages of packages 


Although you don't need to store your procedures and functions within a 
package, there are several advantages to using a package. First, packages help 
you organize your code so all related code is stored in the same package. This 
has the added benefit of avoiding naming conflicts with other procedures or 
functions. Second, packages provide some enhanced functionality. For example, 
if you declare a variable outside of a procedure or function, that variable is 
available within the package for the entire session. Third, packages generally 
provide improved performance since they are loaded into memory when they 
are first used. Last, package specifications reduce unnecessary recompiling of 
dependent procedures and functions in other packages. 
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Code that defines the body for a package named murach (continued) 


FUNCTION get vendor id 
(vendor name param VARCHAR2) 
RETURN NUMBER 
AS 
vendor id var NUMBER; 
BEGIN 
SELECT vendor id 
INTO vendor id var 
FROM vendors 
WHERE vendor name - vendor name param; 


RETURN vendor id var; 
END; 


END murach; 
/ 


А statement that calls a procedure that's stored in a package 
CALL murach.update invoices credit totalí(!'367447', 200); 


А SELECT statement that calls a function that's stored in a package 


SELECT invoice number, invoice total 
FROM invoices 
WHERE vendor id = murach.get vendor id('IBM'); 


The response from the system 


INVOICE, NUMBER la INVOICE_TOTAL 
1 GP58872 11854 ^ 
2 Q545443 1083.58 


A statement that drops the specification and body for a package 
DROP PACKAGE murach; 


A statement that drops only the body for a package 


DROP PACKAGE BODY murach; 


Description 


e A package is a container that allows you to organize and group related stored procedures 
and user-defined functions. 

e The specification of a package lists the names and parameters for its procedures and 
functions. In addition, it specifies the return types for its functions. 

e The body of a package contains the code for its procedures and functions. Within the 
body, the names, parameters, and return types must match the names, parameters, and 
return types in the specification. 


Figure 15-11 How to create and drop packages (part 2 of 2) 
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How to use SQL Developer 


To develop effective stored procedures and functions, you must understand 
the SQL and PL/SQL statements that are presented earlier in this chapter. 
However, once you understand these statements, SQL Developer provides some 
tools that can help you compile, edit, and drop the procedures, functions, and 
packages that you create. In addition, SQL Developer provides an excellent tool 
for debugging stored procedures and functions. 


How to view and drop procedures, functions, and 
packages 


Figure 15-12 shows how to use SQL Developer to view and drop proce- 
dures, functions, and packages. To start, you can view the procedures, functions, 
and packages for a database by connecting to the database and expanding the 
appropriate folder. In this figure, for example, I have expanded the Packages, 
Procedures, and Functions folders so you can see all of the procedures, func- 
tions, and packages that were presented in this chapter. Note that the package 
named MURACH provides separate objects for the specification and the body. 
Note also that you can view the parameters for a procedure or function by 
clicking on the plus sign (+) to the left of its name. 

Once you've displayed one of these database objects, you can drop them by 
right-clicking on the object and selecting the Drop command. Then, you can use 
the resulting dialog box to confirm the drop. 

If you want to view the code for a procedure or function, you can do that by 
clicking on its name. Then, the code for the procedure or function will be 
displayed in the main window. In this figure, for example, I clicked on the 
procedure named update, invoices credit total to display it in the main window. 
At this point, you can view the code for this procedure. 

In addition, you can view other information about the procedure by clicking 
on one of the other tabs. For example, you can click on the Grants tab to view 
the roles and users that have been granted privileges on the object. You can click 
on the Dependencies tab to view the database objects that this object depends 
on. You can click on the References tab to view the database objects that refer to 
this object. And you can click on the Details tab to view other details about this 
object such as the date that the object was created. Before you drop an object, 
you might want to check the References tab to make sure that other objects 
don't reference (depend on) this object. 

Although this figure shows how to view a procedure or function, you can't 
edit the procedure or function until you click on the Edit button in the toolbar. In 
this figure, for example, I have positioned the mouse cursor over the Edit button 
and am about to click on it. If you click on this button, it will display the 
procedure in an Edit window like the one shown in the next figure. 


Chapter 15 Ноу to create stored procedures and functions 


A procedure after it has been viewed in SQL Developer 


Ё Oracle SQL Developer, 


P= f x | 
File Edit View  MHavigete Run Source Vereioning Migretion Toole Help 


Ros 09" шщ 5 - 


Jjres |, (2) [B]tgi5-04sQ |8) 1015-05. &] UPDATE JNvoicES, CREDIT, TOTAL 
Code Grants | Dependencies [References | Details 


Efi connections ЖФ 12 ug actions... 
5-88 «р К 


' E (B Tables 
& (BÀ Views 


сга} replace PROCEDURE црӣаге invoices credit соса] 
t 
invoice nunber param VARCHAR2, 


-A Indexes credit_totel_param NUMBER 
Е-Җ Packages ) 


| EB MuRAcH áx 
Efl MURACH Body 
i be get. vendor Ја 
4] update invoices, credit tctal 
get vendor id 
! update_Involces_cradit_total 
2-08 Procedures 


| 89-41 DROP TABLE UPDATE invoices 
г -4] INSERT. JNvCICE SET credit total = credit total param 


WHERE invoice nunber - invoice number paran; 


BEGIN 
IF credit total param « 0 THEN 
RAISE VALUE ERROR; 
-- RAISE APPLICATION ERROR(-20001, 'Credit total шеу not be negative.!]; 
END IF; 


Nicol сте noces CREDIT TOTAL 
=- Functions 
; 8. ОЕТ BALANCE DUE 
| 8-4% GET_VENDOR_ID 
& (n8 Queues 
& GA Queues Tables 
H-B Triggers 
H-B Types 
8-08 Sequences 
-A Materialized Vieves 
&-üp Materialized Views Logs 
HR Synonyms 
E [99 Public Synonyms 

‚ E (Ф Datanase Links 

|. (BB Public Database Links 


(SOL History 


Description 


e То view the procedures, functions, and packages for a database, you can use SQL 
Developer to connect to the database. Then, you can expand the appropriate folder. 


e To drop a procedure, function, or package, right-click on the object and select the Drop 
command. Then, use the resulting dialog box to confirm the drop. 


e To view the parameters for a procedure or function, expand it by clicking on the plus 
sign (+) to the left of its name. 


e To view the code for a procedure or function, click on its name. Then, the code for the 
procedure or function will be displayed in the main window. 


e To view other information about a procedure or a function, click on its name to display it 
in the main window. Then, click on one of the other tabs (Grants, Dependencies, Refer- 
ences, or Details) to get more information. 


e To edit a stored procedure or function, click on its name to display it in the main win- 
dow. Then, click on the Edit button in the toolbar. 


Figure 15-12 How to view and drop procedures, functions, and packages 
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How to edit and compile procedures and 
functions 


When you run a procedure or function for the first time, Oracle tries to 
compile the procedure. However, if the compiler detects errors, it will display 
them. At this point, you need to fix these errors. Then, to compile the procedure 
or function again, you can use the techniques in figure 15-13. 

When you compile a procedure or function that has errors, the compiler will 
often display error messages that can help you identify the cause of the compila- 
tion error. In this figure, for example, the Compiler – Log window shows an 
error message that clearly indicates that the SET keyword is missing from the 
UPDATE statement. In addition, the Edit window has underlined the section of 
code that caused the error. 

As a result, you can fix this problem by using the Edit window to enter the 
SET keyword in the appropriate place. Once you're done editing the code, you 
can click on the Compile button to recompile the code. If necessary, you can 
repeat this process until you get the code to compile cleanly. Then, you can test 
the code by calling it from a script. 

Note that there are two ways to compile a stored procedure or a function. 
On one hand, you can compile a stored procedure or a function at any time by 
right-clicking on it and selecting the Compile command. On the other hand, if 
the stored procedure or function is open in an Edit window, you can compile it 
by clicking on the Compile button in the toolbar that's displayed at the top of 
the screen. 


How to grant and revoke privileges 


In chapter 12, you learned how to code scripts that grant and revoke privi- 
leges to database objects. Now, this figure shows an easy way to use SQL 
Developer to grant or revoke privileges to your procedures, functions, and 
packages. For example, you can grant privileges to a procedure, function, or 
package by right-clicking on its name and selecting the Grant command. Then, 
you can use the resulting dialog box to specify the role or the user and the 
privileges to be granted. 
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A procedure after it has been displayed in the Edit window 
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How to compile 

e To compile a procedure, function, or package, right-click on its name and select the 
Compile command. 

e Once you display a procedure or function in the Edit window, you can edit the code 
that's stored in the database. In addition, you can use the Compile button in the toolbar to 
compile the code. 


e If the edited code contains errors when you compile it, SQL Developer will display the 
compile-time errors in a Compiler — Log tab at the bottom of the main window. 


How to grant or revoke privileges 

e To grant privileges for a procedure, function, or package, right-click on its name and 
select the Grant command. Then, use the resulting dialog box to specify the user or role 
and the privileges to be granted. 

e To revoke privileges for a procedure, function, or package, right-click on its name and 
select the Revoke command. Then, use the resulting dialog box to specify the user or 
role and the privileges to be revoked. 


Figure 15-13 How to compile procedures and functions 
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How to debug procedures and functions 


After you've successfully compiled a procedure or a function, it still might 
not work properly. For example, you might get an error when you call it. Or, it 
may return unanticipated results. These types of problems are known as bugs. 
When you encounter bugs, you typically want to find them and remove them. 
This is known as debugging. Fortunately, SQL Developer provides a tool known 
as a debugger than can help you find and remove bugs from your program. 

Figure 15-14 shows how to use SQL Developer's debugger. To start, you 
can display the procedure or function that you want to debug in the Edit win- 
dow. Then, you can create a breakpoint by clicking in the margin to the left of a 
statement. This statement will be marked by a red dot in the margin, and the 
execution of the procedure or function will be stopped when it reaches this 
breakpoint. In this figure, for example, I set a breakpoint on the first statement 
in the body of the procedure. 

Once you've set a breakpoint before the section of code that you suspect 
contains the bug, you can click on the Compile for Debug button in the Edit 
window and then on the Debug button. Then, you can use the Debug PL/SQL 
dialog box to specify the values for the input parameters that you want to use 
for debugging. To do that, you code the values in the assignment statements that 
come after the BEGIN keyword in this dialog box. In this figure, for example, I 
assigned a string value of ‘367447’ to the first parameter, and I assigned a 
numeric value of -100 to the second parameter. I picked the -100 value because 
I want to check the IF statement to make sure that it's working properly. 
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A breakpoint in the SQL Developer window 
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Description 


e To set a breakpoint, display the procedure or function in the Edit window. Then, click in 
the margin to the left of the line of code where you want to set the breakpoint. After that, 
a red dot wii] mark the breakpoint. 

• To begin debugging, click the Compile for Debug button in the Edit window. Then, click 
the Debug button to display the Debug PL/SQL dialog box. Here, you can use the 
assignment statements that are after the BEGIN keyword to set the input parameters. 


Figure 15-14 How to debug procedures and functions (part 1 of 2) 
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After you specify the values for the input parameters and click OK, program 
execution will start, but it will stop at the first breakpoint that it encounters. In 
part 2 of this figure, for example, program execution stopped at the breakpoint 
that was set in part 1. 

At any point during the debugging session, you can use the Data window to 
monitor the values of the variables that are in scope. In this figure, for example, 
the only variables that are in scope are the two parameters. However, if other 
variables were in scope, their values would be displayed in this window too. 
Often, you can determine the cause of a bug by viewing the values of these 
variables. 

You can also use the Smart Data window to monitor values that are selected 
automatically by SQL Developer. In this figure, for example, the Smart Data 
window will only display the value of the parameter named credit total param 
because that parameter is close to the execution point. 

To execute the next statement in a procedure or function, you can click on 
one of the Step buttons that are available from the Debugging — Log window. In 
this figure, for example, the mouse cursor is positioned over the Step Over 
button. If you experiment with these buttons, you'll see that they work a little 
differently if your procedure or function calls another procedure or function. 
But if your procedure or function doesn't call other procedures or functions, 
both the Step Over and Step Into buttons execute the next statement in your 
procedure or function. 

In this figure, when I clicked on the Step Over button, program execution 
moved to the RAISE statement. That's because I assigned a value of -100 to the 
parameter named credit total param. 

If you want to continue execution of the program without stepping through 
it, you can click on the Resume button in the Debugging — Log window toolbar. 
Then, execution will continue until it reaches another break point or until the 
program finishes executing. 

When a program contains multiple breakpoints, you can use the 
Breakpoints window view all of the breakpoints. In addition, you can use this 
window to work with these breakpoints. For example, you can right-click in this 
window and select the Disable All command to temporarily disable all 
breakpoints for the application. 

If you want to stop debugging, you can click on the Terminate button in the 
Debugging — Log window toolbar. This immediately ends the debugging 
session. If your debugging session goes well, you can click on this button 
whenever you think you've discovered the cause of a bug and are ready to fix it. 
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A breakpoint in the SQL Developer window 
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Description 


e To step through the code one statement at a time starting at a breakpoint, click on the 
Debugging — Log tab. Then, click on the Step Over, Step Into, or Step Out button. 


e The Step Over button steps over any called procedures or functions. The Step Into button 
steps into called procedures and functions. The Step Out button skips the rest of a called 
procedure or function and returns to the calling procedure or function. 


e То view the values of the variables at each step in the execution of a procedure or 
function, click on the Smart Data or Data tab. 

e To resume execution until the next breakpoint or the end of the procedure or function, 
click on the Resume button. To end debugging, click on the Terminate button. 

e To view the breakpoints for a procedure or function, click on the Breakpoints tab. To 
remove a breakpoint, click on the red marker in the Edit window or right-click on the 
breakpoint in the Breakpoints tab and select the Delete command. 


Figure 15-14 How to debug procedures and functions (part 2 of 2) 
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Perspective 


In this chapter, you've learned how to create two types of executable database 
objects that are supported by Oracle: procedures and functions. You've also 
learned how to organize related procedures and functions within a package. In the 
next chapter, you'll learn how to create a third type of executable database object 
known as a trigger. 

The focus of this chapter has been on the skills that application developers 
typically need for working with procedures and functions. However, you should 
know that there's a lot more to coding procedures and functions than what this 
chapter has shown. With this chapter as background, though, you should be able to 
learn whatever else you need on your own. 

For instance, although this chapter has shown you how to create a function that 
returns a scalar value, you can also create a function that returns a result set. This 
type of function can be useful because it behaves like a view but can accept 
parameters that change the result set. Chances are that you may never need to 
create a function like this. But if you do, you can find more information by search- 
ing for "Oracle table functions" on the Internet. In addition, the downloadable files 
for this chapter include a simple example of a table function. 


Terms 
stored procedure raising an error 
sproc application error 
procedure user-defined function (UDF) 
parameter stored function 
compiling a procedure scalar function 
calling a procedure package 
passing parameters by position subprogram 
passing parameters by name package specification 
input parameter package body 
output parameter bug 
input/output parameter debug 
optional parameter debugger 


data validation breakpoint 
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Exercises 


R 


Create a stored procedure named insert_glaccount that lets a user add a new row 
to the General_Ledger_Accounts table in the AP schema. This procedure should 
have two parameters, one for each of the two columns in this table. Then, code a 
CALL statement that tests the procedure. (Note that this table doesn’t allow 
duplicate account descriptions.) 


Code a script that calls the procedure that you created in exercise 1 and passes 
the parameters by name. This procedure should provide exception handling that 
displays this message if the INSERT statement fails because the account number 
or account description is already in the table (a DUP_VAL_ON_INDEX error): 
A DUP_VAL_ON_INDEX error occurred. 

It should provide this message if any other type of error occurs: 

An unknown exception occurred. 


Code a function named test_glaccounts_description that accepts one parameter 
that tests whether an account description is already in the 
General_Ledger_Accounts table. This function should return a value of 1 if the 
account description is in the table or zero if it isn’t. (Note: If a SELECT 
statement doesn’t return any data, it throws a NO_DATA_FOUND exception 
that your function can handle.) 

Code a script that calls the function that you created in exercise 1. This script 
should display this message if the account description is in the table: 

Account description is already in use. 

It should provide this message if any other type of error occurs: 

Account description is available. 

Modify the stored procedure that you created in exercise 1 and save it as 
insert_glaccount_with_test. This procedure should use the function that you 
created in step 3 to test whether the account description is going to be okay 
before it issues the INSERT statement. If the account description is a duplicate, 
this procedure should raise an application error with -20002 as the error number 
and an error message of 


Duplicate account description 


Modify the script that you created in step 2 so it uses the procedure of exercise 
5. This script should use the SQLERRM function to display the error number 
and message for the application error if the account description is already in use. 
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How to create triggers 


Now that you've learned how to work with stored procedures and user-defined 
functions, you're ready to learn about another type of executable database 
object: a trigger. Triggers provide a powerful way to control the SQL 
statements that modify the data in your database. Since you can program 
virtually any logic within the code for a trigger, you can use triggers to enforce 
data consistency with a flexibility that isn't available from other database 
features such as constraints. In addition, you can use triggers to log changes to 
the database, provide for updateable views, and implement business rules. 
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How to work with triggers 


A trigger is a named block of PL/SQL code that is executed, or fired, auto- 
matically when a particular type of SQL statement is executed. Most of the time, 
a trigger is fired when an INSERT, UPDATE, or DELETE statement is executed 
on a table or view. However, it's also possible to create a trigger that's fired when 
a DDL statement such as a CREATE, ALTER, or DROP statement is executed. 


How to create a BEFORE trigger for a table 


Figure 16-1 presents the syntax for a CREATE TRIGGER statement that 
creates a trigger that fires when INSERT, UPDATE, or DELETE statements are 
executed on a table. To start, you code the CREATE keyword, followed by the 
optional OR REPLACE keywords, followed by the TRIGGER keyword, followed 
by the name of the trigger. In the example in this figure, the statement creates a 
trigger named vendors, before update state. Since this statement includes the OR 
REPLACE keywords, it creates the trigger if it doesn't already exist, and it 
replaces the trigger if it does already exist. 

Note that the name of this trigger indicates that this trigger is associated with 
the Vendors table and that it is fired before an update of the vendor, state column. 
Throughout this chapter, I will use a similar naming convention for the other 
triggers. 

After the name of the trigger, you code the BEFORE or AFTER keyword that 
indicates when the trigger is fired. Then, you code a list of statement types that 
cause the trigger to fire, separating each statement type with the OR keyword. For 
an UPDATE statement, you can use the optional OF keyword to specify a list of 
columns that limits when the trigger is fired. If you specify multiple columns, 
you separate the columns with commas. Finally, you code an ON clause that 
identifies the name of the table. In the example in this figure, the first statement 
creates a trigger that's executed before any INSERT statements on the Vendors 
table and before any UPDATE statements that update the vendor, state column of 
the Vendors table. 

After the ON clause, you can optionally specify the FOR EACH ROW clause 
to indicate that the trigger is a row-level trigger that will fire for each row that's 
modified. If you don't code this clause, the trigger is a statement-level trigger 
that's only executed once for each statement. 

If you specify a FOR EACH ROW clause, you can optionally specify a 
WHEN clause to control when the trigger is fired. To code a WHEN clause, you 
code the WHEN keyword followed by a set of parentheses. Within the parenthe- 
ses, you can code a condition that evaluates to True or False. 

Within a WHEN clause, you can code a correlation identifier to work with 
the new values in the row that's being inserted or updated. Or, you can use a 
correlation identifier to work with the old values in the row that's being updated 
or deleted. By default, the correlation identifiers are named NEW and OLD. In 
this figure, for example, the NEW identifier is used to get the value for the 
vendor. state column of the new row. 
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The syntax of the CREATE TRIGGER statement for a table 


CREATE [OR REPLACE] TRIGGER trigger name 

(BEFORE | AFTER) 

{DELETE | INSERT | UPDATE [OF col namel [, col name2]...1) 

[OR {DELETE|INSERT|UPDATE [OF col namel [, col name2]...1)]... 
ON table name 

[FOR EACH ROW 

[WHEN (trigger condition)]] 

pl sgl block 


А CREATE TRIGGER statement that corrects mixed-case state names 
CREATE OR REPLACE TRIGGER vendors before update state 
BEFORE INSERT OR UPDATE OF vendor state 
ON vendors 
FOR EACH ROW 


WHEN (NEW.vendor state l= UPPER(NEW.vendor state)) 
BEGIN 


:NEW.vendor state := UPPER(:NEW.vendor state); 
END; 


/ 


An UPDATE statement that fires the trigger 


UPDATE vendors 
SET vendor state = 'wi' 
WHERE vendor id = 1; 


А SELECT statement that shows the new row 


SELECT vendor name, vendor state 
FROM vendors 
WHERE vendor id - 1; 


The result set 


Ш veNDOR МАМЕ | VENDOR_STATE 


1 US Postal Service — vM s 

Description 

e A trigger is a named block of PL/SQL code that executes, or fires, in response to an 
event. 


e You can fire a trigger before or after an INSERT, UPDATE, or DELETE statement is 
executed on a table. 


e Ifyou don't specify a FOR EACH ROW clause, the trigger is a statement-level trigger 
that fires once for each statement. 


e Ifyou specify a FOR EACH ROW clause, the trigger is a row-level trigger that fires 
once for each row that's modified. For a row-level trigger, you can use the OLD and 
NEW correlation identifiers to work with the values for the columns that are stored in 
the old row and the new row. 


Figure 16-1 How to create a BEFORE trigger for a table 
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When you use the NEW and OLD identifiers, you’ll get a NULL value if 
you use the NEW identifier for a row that’s about to be deleted since this row 
doesn't have any new values. Conversely, you'll get a NULL value if you use 
the OLD identifier for a row that's about to be inserted since this row doesn't 
have any old values. Finally, note that you don't need to preface the NEW and 
OLD identifier with a colon (:) when they're used within the WHEN clause. 
However, you do need to preface these keyword with a colon when they're not 
used within the WHEN clause. This syntax is similar to the syntax for working 
with a bind variable, and it indicates that the NEW and OLD identifiers are a 
special type of variable that's similar to a bind variable. 

The body for this trigger is a PL/SQL block that contains a single statement. 
This statement, updates the vendor, state column so that state codes are always 
stored with uppercase letters. To accomplish this, this statement uses the UP- 
PER function to convert the new value for the vendor state column to upper- 
case. 


How to use a trigger to enforce data consistency 


Triggers are commonly used to enforce data consistency. For example, the 
sum of line item amounts in the Invoice Line Items table should always be 
equal to the corresponding invoice total amount in the Invoices table. However, 
you can't enforce this constraint on the Invoices table or the Invoice Line Items 
table. To do that, you need to use a trigger like the one in figure 16-2. 

To understand how this trigger works, consider how an invoice is entered 
into the database. First, you must insert the invoice into the Invoices table. If 
you tried to insert the line items first, you'd violate referential integrity since the 
value for the invoice id column hasn't been inserted into the database yet. Once 
the invoice has been inserted, you can insert the first line item into the 
Invoice Line Items table. However, you can't constrain the value for the line 
item amount because the constraint would have to be based on the value in the 
Invoices table. In addition, even if you could implement such a constraint, you 
would only want to do so once the last line item was inserted. Then, you'd want 
to be sure that the sum of the line item amounts equaled the invoice total. 

The trigger shown here enforces this rule by firing after an UPDATE 
statement attempts to update the invoice, total column in the Invoices table. 
When the trigger fires, it tries to verify that the sum of the line items is equal to 
the invoice total. If this isn't true, the trigger raises an error. Then, the applica- 
tion that issued the UPDATE statement can handle the exception. 

Although this example isn't entirely realistic, you can use triggers like this 
to enforce business rules or to verify data consistency. Since you can program a 
trigger to accommodate most situations, triggers are more flexible than con- 
straints. 


Chapter 16 Ноу to create triggers 507 


A trigger that validates line item amounts when updating the invoice total 


CREATE OR REPLACE TRIGGER invoices before update total 
BEFORE UPDATE OF invoice total 
ON invoices 
FOR EACH ROW 
DECLARE 
sum line item amount NUMBER; 
BEGIN 
SELECT SUM(line item amt) 
INTO sum line item amount 
FROM invoice line items 
WHERE invoice id = :new.invoice id; 


IF sum line item amount l= :new.invoice total THEN 
RAISE APPLICATION ERROR(-20001, 
'Line item total must match invoice total.'); 
END IF; 
END; 
/ 


An UPDATE statement that fires the trigger 


UPDATE invoices 

SET invoice total = 600 

WHERE invoice id = 100; 

The response from the system 


ORA-20001: Line item total must match invoice total. 


Description 
e Triggers can be used to enforce rules for data consistency that can’t be enforced by 
constraints. 


Figure 16-2 How to use a trigger to enforce data consistency 
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How to use a trigger to work with a sequence 


When you create a sequence that generates a value for column in a table, 
you typically want to use that value every time you insert a new row. To illus- 
trate, let's assume that you have defined a sequence named invoice, id, seq that 
generates a unique value for the invoice id column of the Invoices table. In that 
case, you want to use this sequence every time you insert a new row in the 
Invoices table. 

To do this automatically, you can use a trigger like the one in figure 16-3. 
Here, the trigger is executed before a row is inserted into the Invoices table. 
However, this trigger is only executed if the value of the invoice id column in 
the new row is a NULL value. As a result, if the new row already contains a 
value for the invoice id column, the trigger isn't executed. 

Within the body of this statement, a single SELECT statement uses the 
NEXTVAL pseudo column of the sequence named invoice, id, seq to select the 
next value of the sequence into the invoice id column of the new row that's 
being inserted. Аз a result, an INSERT statement on the Invoices table doesn't 
need to specify a value for the invoice, id column since this value is set auto- 
matically by the trigger. 

As you review this code, note that the WHEN clause is necessary because 
other programs might issue INSERT statements that call the NEXTVAL pseudo 
column of the sequence. In that case, the WHEN clause prevents the NEXTVAL 
pseudo column from being called twice before the row is inserted. For example, 
the trigger shown in figure 16-5 issues an INSERT statement that calls the 
NEXTVAL pseudo column. Аз a result, if you didn't include the WHEN clause 
in this trigger, these two triggers would cause a gap in the numbering sequence. 
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A trigger that sets the next primary key value for a row 


CREATE OR REPLACE TRIGGER invoices before insert 
BEFORE INSERT ON invoices 
FOR EACH ROW 
WHEN (NEW.invoice id IS NULL) 
BEGIN 
SELECT invoice id seq.NEXTVAL 
INTO :new.invoice id 
FROM dual; 
END; 
/ 


An INSERT statement that fires the trigger 


INSERT INTO invoices 

(vendor id, invoice number, invoice date, invoice total, terms id, 
invoice due date) 

VALUES 

(34, 'ZXA-080', '30-AUG-08', 14092.59, 3, '30-SEP-08'); 


А SELECT statement that retrieves the row that was inserted 
SELECT * FROM invoices WHERE invoice number = 'ZXA-080'; 


The result set 


voice Ip |] VENDOR iD |l] INVOIcE_NUMBER Ш INvoice pate Ш мос тота: |] PAYMENT_TOTAL 


34 ZXA-D80 30-AUG-08 14032.53 


Description 


e You can use a trigger to set a value in a new row that's about to be inserted with a value 
that's generated by a sequence. 


Figure 16-3 How to use a trigger to work with a sequence 
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How to create an AFTER trigger for a table 


Triggers are commonly used to store information about events that occur in 
a database so these events can be reviewed later. In particular, AFTER triggers 
are used to store information about a statement after it executes. Figure 16-4 
shows how this works. 

To start, this figure shows a CREATE TABLE statement that creates a table 
named Invoices Audit. This table contains five columns that store information 
about the action that occurred on the Invoices table. Of these columns, the first 
three store values from the Invoices table, and the last two store information 
about the action that caused the statement to execute. 

After the CREATE TABLE statement, this figure shows a CREATE TRIG- 
GER statement that creates a trigger that executes after an INSERT, UPDATE, 
or DELETE statement is executed on the Invoices table. The body of this trigger 
uses an IF statement with the INSERTING, UPDATING, and DELETING 
trigger predicates to check the type of the event that caused the trigger to fire. 
Then, the trigger executes an appropriate INSERT statement depending on 
whether data in the table has been inserted, updated, or deleted. If, for example, 
data has been inserted into the table, the first INSERT statement in the trigger is 
executed. This inserts the new values for the vendor. id, invoice number, and 
invoice total columns into the Іпуоісеѕ Audit table. In addition, it inserts а 
string value of “Inserted” to indicate that the row has been inserted, and it uses 
the SYSDATE function to insert the date of the action. 

Note that the first INSERT statement inserts the new values for the row 
that's being inserted since there aren't any old values for this row. However, the 
second and third INSERT statements insert the old values for the row that's 
being updated or deleted since there are old values for these rows. 

Although the example that's presented in this figure has been simplified, it 
presents all of the skills that you need for creating more complex audit tables. 
For example, if you're having a problem updating rows in a database, you can 
create an audit table and a trigger to store whatever data you want to store about 
each update. Then, the next time the update problem occurs, you can review the 
data in the audit table to identify the cause of the problem. 
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А statement that creates an audit table for actions on the invoices table 


CREATE TABLE invoices audit 
( 


vendor id NUMBER NOT NULL, 
invoice number VARCHAR2 (50) NOT NULL, 
invoice total NUMBER NOT NULL, 
action type VARCHAR2 (50) NOT NULL, 
action date DATE NOT NULL 


); 


An AFTER trigger that inserts rows into the audit table 


CREATE OR REPLACE TRIGGER invoices after dml 
AFTER INSERT OR UPDATE OR DELETE 
ON invoices 
FOR EACH ROW 
BEGIN 
IF INSERTING THEN 
INSERT INTO invoices audit VALUES 
(1new.vendor id, :new.invoice number, :new.invoice total, 
'INSERTED', SYSDATE); 
ELSIF UPDATING THEN 
INSERT INTO invoices audit VALUES 
(101d.vendor id, :old.invoice number, :old.invoice total, 
'UPDATED', SYSDATE) ; 
ELSIF DELETING THEN 
INSERT INTO invoices audit VALUES 
(:01d.vendor id, :old.invoice number, :old.invoice total, 
'DELETED', SYSDATE); 
END IF; 
END; 
/ 


An INSERT statement that causes the trigger to fire 


INSERT INTO invoices VALUES 
(115, 34, !ZXA-080!, 130-AUG-08!, 14092.59, 0, 0, 3, !130-SEP-08!, NULL); 


A DELETE statement that causes the trigger to fire 


DELETE FROM invoices WHERE invoice number = 'ZXA-080'; 

A SELECT statement that retrieves the rows in the audit table 
SELECT * FROM invoices deleted; 
The result set 


VENDOR, D |) INVOICE_NUMBER |l] iwvoice Tora. |l] АСТОМ ТҮРЕ | ACTION DATE 
1 34 ZXA-080 14092.59 INSERTED 13-OCT-06 


2 34 ZXA4-060 14092.59 DELETED 13-OCT-06 


Description 
e ‘You can use an AFTER trigger to insert rows into an audit table. 


e Ifa trigger works for multiple types of DML statements, you can use the INSERTING, 
UPDATING, and DELETING trigger predicates to check the type of DML statement 
that caused the trigger to fire. 


Figure 16-4 Ном to create an AFTER trigger for a table 
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How to use an INSTEAD OF trigger for a view 


In chapter 11, you learned how to create updateable views, and you learned 
that there are some limitations to updating data in updateable views. Now, 
you'll learn how you can use an INSTEAD OF trigger to get around many of 
those limitations. To do that, you can code an INSTEAD OF trigger that ex- 
ecutes an INSERT, UPDATE, or DELETE statement on the underlying table or 
tables that the view is based on instead of attempting to insert, update, or delete 
data through the view. 

Figure 16-5 shows the syntax for using an INSTEAD OF trigger on a view. 
If you compare this syntax with the syntax for using a BEFORE or AFTER 
trigger on a table, you'll see that they're similar. Аз a result, you shouldn't have 
much trouble understanding this syntax. 

The INSTEAD OF trigger in this figure allows you to insert rows into the 
view named IBM_Invoices that was presented in figure 11-6. This view selects 
invoices from the Invoices table for the vendor named IBM, which has a vendor 
ID of 34. Since some of the columns that are required for an INSERT statement 
aren't included in the view, you can't insert data through this view unless you 
create a trigger like the one in this figure. 

This trigger accommodates the missing columns by calculating their values 
based on three logical assumptions. First, the invoice ID can be retrieved from a 
sequence. Second, the vendor ID can be assumed to be 34 because that's part of 
the definition of the view. Third, the terms ID for the invoice can be assumed to 
be 3 since this is the default terms ID for this vendor. Fourth, the due date for 
the invoice can be calculated based on the invoice date and the terms that 
correspond with the terms ID value. In this case, the invoice must be paid within 
30 days of the invoice date. In addition, this trigger uses the NEW identifier to 
retrieve the values from the new row that the INSERT statement is attempting to 
insert. 

Since an INSTEAD OF trigger is executed instead of the SQL statement 
that caused it to fire, the SQL statement won't execute unless you code it as part 
of the trigger. That's why the only statement in the body of this trigger is an 
INSERT statement that inserts the new row into the underlying Invoices table. 

If a stored procedure is available that does what you want it to do, you can 
call that procedure from a trigger. For instance, you can use the stored proce- 
dure named insert, invoice in figure 15-5 of the last chapter instead of the 
INSERT statement shown in this figure. To do that, you call the insert, invoice 
procedure from the trigger like this: 

insert invoice(34, :new.invoice number, :new.invoice date, 

:new.invoice total); 
This approach has two advantages. First, it makes your code easier to maintain 
by allowing you to store all logic for inserting an invoice in one location. 
Second, it makes your code more flexible since the procedure looks up the 
terms ID and calculates the due date based on that value. 
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The syntax of the CREATE TRIGGER statement for a view 
CREATE [OR REPLACE] TRIGGER trigger name 
INSTEAD OF 
(DELETE|INSERT|UPDATE [OF col namel [, ] col name2...]) 


[OR [DELETE|INSERT|UPDATE [OF col namel [, ] col name2...1]]... 
ON view name 


[FOR EACH ROW 
[WHEN (trigger condition)]] 
pl sql block 


А statement that creates a view 


CREATE OR REPLACE VIEW ibm invoices AS 


SELECT invoice number, invoice date, invoice total 
FROM invoices 


WHERE vendor id = 34; 


An INSTEAD OF INSERT trigger for a view 


CREATE OR REPLACE TRIGGER ibm invoices instead of insert 
INSTEAD OF INSERT 


ON ibm invoices 
BEGIN 


INSERT INTO invoices VALUES 


(invoice id seq.NEXTVAL, 34, :new.invoice number, :new.invoice date, 


:new.invoice total, 0, 0, 3, :new.invoice date + 30, NULL); 
END; 


/ 


An INSERT statement that succeeds due to the trigger 


INSERT INTO ibm invoices VALUES ('ZXA-080', '30-AUG-08', 14092.59); 


А SELECT statement that retrieves the rows from the view 
SELECT * FROM ibm invoices; 


The result set 


ü] INVOICE NUMBER INVOICE DATE INVOICE TOTAL 


1 244-080 30-4UG-06 14092.59 ^ 
2 QP58872 25-FEB-08 115.54 
3 9545443 14-M A R-08 1083.58 

Description 


You can use an INSTEAD OF trigger to make views updatable by executing INSERT, 
UPDATE, or DELETE statements on the underlying table or tables of the view instead of 
attempting to insert, update, or delete data through the view. 


Figure 16-5 How to use an INSTEAD OF trigger for a view 
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How to use a trigger to work with DDL statements 


So far, you've learned how to use a trigger to work with DML statements 
such as INSERT, UPDATE, and DELETE statements. However, you can also 
use a trigger to work with DDL statements such as CREATE, ALTER, and 
DROP statements as shown in figure 16-6. 

When you code a trigger that works with DDL statements, the trigger can 
respond to the DDL events shown in this figure. For example, to fire the trigger 
for most DDL events, you can code the DDL keyword. Or, you can code the 
keyword for a more specific DDL event such as the CREATE event or the 
DROP event. If you code more than one DDL event, you must separate the 
different events with the OR keyword. 

Within the ON clause, you can specify that you only want the trigger to fire 
for a specific schema by coding the name of the schema, followed by a dot 
operator, followed by the SCHEMA keyword. Or, you can code the SCHEMA 
keyword without explicitly specifying the name of the schema. In that case, the 
trigger fires for DDL events on the same schema that contains the trigger. On 
the other hand, if you want the trigger to fire for all schemas on the current 
database server, you can code the DATABASE keyword instead of the 
SCHEMA keyword. 

In the example in this figure, the trigger fires before à CREATE or DROP 
statement is executed on the AP schema. Then, the body of the trigger raises an 
application error, which prevents the CREATE or DROP statement from execut- 
ing. In this example, the trigger prevents the CREATE TABLE statement from 
executing. But it will also prevent any other CREATE statements such as a 
CREATE VIEW statement from executing. 

Fortunately, though, this trigger doesn't prevent a user with the appropriate 
privileges from dropping the trigger later. Otherwise, it would be possible to 
accidentally create a trigger that would prevent you from making any changes to 
the database objects in your database. 


How to use a trigger to work with database 
events 


If necessary, you can use a trigger to respond to database events such as 
when the database starts up or shuts down or when a user logs on or off. To do 
that, you can use a syntax that's similar to the syntax in this figure. However, 
you use the DATABASE keyword, and you specify database events such as the 
STARTUP, SHUTDOWN, LOGON, and LOGOFF events. Since these types of 
triggers are typically coded by DBAs, they aren't presented in this book. For 
more information about them, you can search the Internet. 
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The syntax of the CREATE TRIGGER statement for a DDL statement 


CREATE [OR REPLACE] TRIGGER trigger name 
(BEFORE|AFTER) ddl event [OR ddl event]... 
ON {[schema_name.] SCHEMA | DATABASE} 

pl sql block 


DDL events 
DDL event Description 


Fired when an object is created. 

Fired when an object is altered. 

Fired when an object is dropped. 

Fired when a GRANT statement is issued. 
Fired when a REVOKE statement is issued. 
Fired when most DDL statements are issued. 


A trigger that works with DDL statements 


CREATE OR REPLACE TRIGGER ap before create drop 
BEFORE CREATE OR DROP ON ap.SCHEMA 
BEGIN 
RAISE APPLICATION ERROR(-20001, 
'You cannot create or drop an object in the AP schema!); 
END; 
/ 


A CREATE TABLE statement that fires the trigger 


CREATE TABLE ap.testl (test id NUMBER); 


The response from the system 
ORA-20001: You cannot create or drop an object in the AP schema 


Description 


e Inthe ON clause, you can use the SCHEMA keyword to fire the trigger when DDL 
events occur on the specified schema. If you don't explicitly specify the schema, the 
statement will use the schema that contains the trigger. 


e Inthe ON clause, you can use the DATABASE keyword to fire the trigger when DDL 
events occur on any schema on the current server. 


Figure 16-6 How to use a trigger to work with DDL statements 
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How to enable, disable, rename, or drop a trigger 


If the tables that you’re working with contain triggers, you may want to 
temporarily disable them before you perform certain functions. For example, 
you may want to disable the triggers for one or more tables before inserting a 
large number of rows into the table or tables. This can help the INSERT state- 
ments run faster and it lets you insert data that isn’t allowed by the triggers. 
Then, when you’re done, you can enable the triggers that were disabled. 

Figure 16-7 shows how to code the SQL statements that enable and disable 
triggers. In addition, it shows how to code the SQL statements that rename or 
drop a trigger. 

To enable or disable a specific trigger, you code the ALTER TRIGGER 
keywords, followed by the name of the trigger, followed by the ENABLE or 
DISABLE keywords. In this figure, the first example disables the trigger that 
was created in the previous figure so objects can be created and dropped within 
the AP schema. Then, it creates and drops a table. Finally, it enables the trigger 
so objects can’t be created and dropped within the AP schema. 

To enable or disable all triggers for a table, you code the ALTER TRIGGER 
keywords, followed by the name of the table, followed by the ENABLE or 
DISABLE keywords, followed by the ALL TRIGGERS keywords. In this 
figure, the second example disables all triggers for the Invoices table. Then, it 
enables all of the triggers for the Invoices table. 

To rename a trigger, you code the ALTER TRIGGER keywords, followed 
by the old name of the trigger, followed by the RENAME TO keywords, fol- 
lowed by the new name for the trigger. In this figure, the third example renames 
the trigger that was created in figure 16-2. 

To drop a trigger, you code the DROP TRIGGER keywords followed by the 
name of the trigger. In this figure, the fourth example uses the DROP TRIGGER 
statement to drop the trigger that was created in the previous figure. 

If you drop a table, sequence, or view used by a trigger, you should be sure 
to drop or disable the trigger as well. If you don’t, the trigger can still be fired 
by a database user. Then, an error will occur because the table, sequence, or 
view that the trigger depends on no longer exists. 
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Statements that disable and enable a trigger 


ALTER TRIGGER ap before create DISABLE; 
CREATE TABLE testl (test id NUMBER); 
DROP TABLE testl; 

ALTER TRIGGER ap before create ENABLE; 


Statements that disable and enable all triggers for a table 


ALTER TABLE invoices DISABLE ALL TRIGGERS; 
ALTER TABLE invoices ENABLE ALL TRIGGERS; 


А statement that renames a trigger 


ALTER TRIGGER invoices before update total 
RENAME TO invoices before update inv tot; 


А statement that drops a trigger 
DROP TRIGGER ap before create; 


Description 


e To enable or disable a specific trigger, use the ALTER TRIGGER statement with the 
ENABLE or DISABLE keywords. 


e To enable or disable all triggers for a table, use the ALTER TRIGGER statement with the 
ENABLE or DISABLE keywords and the ALL TRIGGERS keywords. 


e To rename a trigger, use the ALTER TRIGGER statement with the RENAME TO 
keywords. 


e To drop a trigger, use the DROP TRIGGER statement. 


Figure 16-7 How to enable, disable, rename, or drop a trigger 
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Other skills for working with triggers 


Oracle Database 11g introduced a new type of trigger known as a com- 
pound trigger. This type of trigger provides an easy way to solve a well-known 
Oracle error that was difficult to solve with the old trigger types. 


How to code a compound trigger 


A compound trigger can contain blocks of PL/SQL code that are executed 
(1) before the triggering statement is executed, (2) before the row is modified, 
(3) after the row is modified, or (4) after the triggering statement has finished 
executing. In addition, a compound trigger can share variables between these 
blocks of code. 

In figure 16-8, for example, the body of the trigger begins by declaring a 
variable that stores an integer value. Then, it uses the BEFORE STATEMENT, 
BEFORE EACH ROW, AFTER EACH ROW, and AFTER STATEMENT 
blocks to display the value of this variable. This shows that all four blocks can 
access the value that's stored in the variable. In addition, it shows how to code 
all four blocks for a compound trigger. Note, however, that it’s common to code 
a compound trigger that only has two blocks. 

When you declare a compound trigger, you use the FOR keyword instead of 
the BEFORE or AFTER keywords to identify the DML event that causes the 
trigger to fire. This makes sense because a compound trigger can execute both 
BEFORE and AFTER a DML statement. In addition, you use the COMPOUND 
TRIGGER keywords to identify the beginning of the trigger. Then, within each 
BEFORE or AFTER block you use the IS keyword to identify the beginning of 
the PL/SQL block, and you use the corresponding END clause to end each 
block. 

Note that the statements that print data to the output window are coded 
within the trigger. However, the SET SERVEROUTPUT ON command that 
enables the buffer for these statements is called before the UPDATE statement 
that fires the trigger. This is necessary because the SET SERVEROUTPUT ON 
command isn't a valid PL/SQL statement. Instead, this command works with 
external tools such as SQL*Plus and SQL Developer. 
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А compound trigger 


CREATE OR REPLACE TRIGGER invoices compound update 
FOR UPDATE OF invoice total, credit total 
ON invoices 
COMPOUND TRIGGER 
test value NUMBER := 1; 


BEFORE STATEMENT IS 
BEGIN 

DBMS OUTPUT.PUT LINE('before statement: ' || test value); 
END BEPORE STATEMENT; 


BEFORE EACH ROW IS 
BEGIN 

DBMS OUTPUT.PUT LINE('before row: ' || test value); 
END BEFORE EACH ROW; 


AFTER EACH ROW I8 
BEGIN 

DBMS OUTPUT.PUT LINE('after row: ' || test value); 
END AFTER EACH ROW; 


AFTER STATEMENT IS 
BEGIN 
DBMS OUTPUT.PUT LINE('after statement: ' || test value); 
END AFTER STATEMENT; 
END; 


/ 


A script that fires the trigger 


SET SERVEROUTPUT ON; 


UPDATE invoices 
SET credit total 
WHERE invoice id 


0 
100; 


The response from the system 


before statement: 1 
before row: 1 

after row: 1 

after statement: 1 


Description 


А compound trigger can contain blocks of code that are executed (1) before the trigger- 
ing statement is executed, (2) before the row is modified, (3) after the row is modified, or 
(4) after the triggering statement has finished executing. 


Within the body of a compound trigger, you can declare variables that are shared be- 
tween the blocks within the body of the trigger. 


You use the FOR keyword to identify the DML event that fires the compound trigger. 


You use the COMPOUND TRIGGER keywords to identify the start of the body for the 
trigger. 


Compound triggers were introduced with Oracle Database 11g. 


Figure 16-8 How to code a compound trigger 
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А trigger that causes the mutating-table error 


If you code a row-level trigger that issues a SELECT statement against the 
same table that the trigger is defined on, the trigger will compile cleanly. 
However, when you execute a statement that fires the trigger, you'll get an error 
that is known as the mutating-table error. This error includes a message that 
indicates that the table is mutating and that the trigger might not be able to 
"see" the changes. As a result, the trigger fails to execute properly. 

To understand this error more thoroughly, let's assume that you have a 
business rule that says that the credit total for an invoice should never be greater 
than the maximum invoice total for a vendor. Unfortunately, this business rule is 
too complex to implement with a constraint. At first glance, though, it seems 
like you should be able to implement this business rule by coding a trigger like 
the one shown in figure 16-9. 

Here, the declaration for the trigger indicates that the trigger executes 
before an UPDATE statement is executed against each row of the Invoices table. 
Then, the body of the trigger declares a variable and uses a SELECT statement 
to store the maximum invoice total for the vendor in the variable. Finally, this 
trigger uses an IF statement to check if the new credit total is greater than the 
maximum invoice total that's stored in the variable. If so, the trigger raises an 
appropriate application error, which prevents the UPDATE statement from 
executing. 

When you run this CREATE TRIGGER statement, it compiles cleanly. 
However, when you issue an UPDATE statement like the one in this figure, 
Oracle returns the mutating-table error because the trigger is attempting to read 
data from the table at the same time that the UPDATE statement is attempting to 
update the table. 

At this point, you may wonder why this trigger causes the mutating-table 
error while the trigger presented in figure 16-2 does not. If you compare these 
triggers, you'll see that they're both row-level triggers based on the Invoices 
table and that they both use a SELECT statement within the body of the trigger. 
However, the trigger in figure 16-2 selects data from the Invoice Line Items 
table. Аз a result, it doesn't cause the mutating-table error. 

If your trigger doesn't need to use the NEW or OLD identifiers, you can 
solve the mutating-table error by removing the FOR EACH ROW clause from 
the trigger. In that case, the row-level trigger will be converted to a statement- 
level trigger, and the mutating-table error won't occur. Unfortunately, the trigger 
shown in this figure needs to use the NEW identifier to check the new credit 
total for the row. 
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A trigger that causes the mutating-table error 


CREATE OR REPLACE TRIGGER invoices before update total 2 
BEFORE UPDATE OF invoice total, credit total 
ON invoices 
FOR EACH ROW 
DECLARE 

max invoice total NUMBER; 
BEGIN 

SELECT MAX(invoice total) 

INTO max invoice total 

FROM invoices 

WHERE invoice id = :new.invoice id; 


IF (:new.credit total » max invoice total) THEN 
RAISE APPLICATION ERROR(-20001, 
'invoice credit value may not exceed the maximum invoice total value.'); 
END IF; 
END; 
/ 


А statement that fires the trigger 


UPDATE invoices 
SET credit total 
WHERE invoice id 


0 
100; 


The response from the system 
ORA-04091: table AP.INVOICES is mutating, trigger/function may not see it 


Description 


e The mutating-table error is raised when a trigger attempts to execute a SELECT state- 
ment on the same table that the trigger is defined on. 


Figure 16-9 A trigger that causes the mutating-table error 
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How to solve the mutating-table problem 


Figure 16-10 shows how to use compound triggers to solve the mutating- 
table problem. This trigger works because it uses a statement-level trigger to 
execute the SELECT statement that retrieves the data before the triggering 
statement is executed, and it stores this data in variables. Then, it uses a row- 
level trigger to process each row using the data that has been stored the vari- 
ables. As a result, the row-level trigger never attempts to retrieve data from the 
table while it is mutating. 

Since compound triggers were introduced with Oracle Database 11g, this 
solution will only work with Oracle 11g or later. As a result, if you're using an 
earlier version of Oracle, you will have to use an older workaround that involves 
coding a statement-level trigger, a row-level trigger, and a package that stores 
the variables that are used by these triggers. Fortunately, this workaround is 
well-documented, and you should be able to find plenty of information about it 
by searching the web. 

The trigger shown in this figure is a compound trigger that's fired when the 
invoice total or credit total column of the Invoice table is updated. This trigger 
begins by declaring some variables that store data about the maximum invoice 
total for each vendor. In particular, the first two statements declare nested tables 
that store the vendor IDs and maximum invoice totals for each vendor. Then, the 
third statement declares an index-by table. This table is later used to store the 
maximum invoice totals for each vendor and to index these values by vendor 
ID. Finally, the next three statements assign these three collections to variables 
named vendor. ids, max. invoice. totals, and ids. totals. 

After this trigger declares these variables, it executes the code in the BE- 
FORE STATEMENT block. This block begins by declaring two NUMBER 
variables, one to store the vendor ID and one to store the maximum invoice 
total. Then, this code uses a SELECT statement to select the vendor IDs and the 
maximum invoice totals into their corresponding variables. To accomplish this 
task, this SELECT statement uses the BULK COLLECT keywords. In addition, 
it uses a GROUP BY clause to create a summary query. As a result, this SE- 
LECT statement will only return one row for each vendor. 

After the SELECT statement, a FOR loop stores the vendor IDs and maxi- 
mum invoice totals in the variable named ids, totals. Within the loop, the first 
two statements use the counter variable for the loop to return the values for the 
vendor ID and the maximum invoice total. Finally, the last statement in the loop 
stores the maximum invoice total in the id totals variable, and it uses the vendor 
ID value as the index. 

After the BEFORE STATEMENT block, the code in the BEFORE EACH 
ROW block begins by declaring a NUMBER variable to store the maximum 
invoice total that's retrieved from the indexed table. Then, it uses the new 
vendor ID value to retrieve the maximum invoice total for the vendor. Finally, it 
uses an IF statement to check if the new credit total value is greater than the 
maximum invoice total value. If so, this trigger raises an application error. 
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А compound trigger that solves the mutating-table problem 


CREATE OR REPLACE TRIGGER invoices before update total 2 
FOR UPDATE OF invoice total, credit total 

ON invoices 

COMPOUND TRIGGER 


TYPE vendor ids table IS TABLE OF NUMBER; 
TYPE max invoice totals table IS TABLE OF NUMBER; 
TYPE ids totals table IS TABLE OF NUMBER 


INDEX BY BINARY INTEGER; 


vendor ids vendor ids table; 
max invoice totals max invoice totals table; 
іда totals ідз totals table; 


BEFORE STATEMENT IS 
vendor id NUMBER; 
max invoice total NUMBER; 
BEGIN 
SELECT vendor id, MAX(invoice total) 
BULK COLLECT INTO vendor ids, max invoice totals 
FROM invoices 
GROUP BY vendor id; 


FOR i IN l..vendor ids.COUNT() LOOP 
vendor id := vendor ids(1); 
max invoice total:= max invoice totals(i); 
ids totals(vendor id) := max invoice total; 
END LOOP; 
END BEFORE STATEMENT; 


BEFORE EACH ROW IS 
max invoice total NUMBER; 
BEGIN 
max invoice total :- ids totals(:new.vendor id); 
IF :new.credit total » max invoice total THEN 
RAISE APPLICATION ERROR(-20001, 
'invoice credit value may not exceed the maximum 
invoice total value for a vendor.'); 
END ТР) 
END BEFORE BACH ROW; 


END; 
/ 


А statement that fires the trigger 


UPDATE invoices 
SET credit total 
WHERE invoice id 


The response from the system 


ORA-20001: invoice credit value may not exceed the maximum invoice total 
value for a vendor. 


1000 
100; 


Description 
e With Oracle 11g, you can use compound triggers to solve the mutating-table error. 


Figure 16-10 How to solve the mutating-table problem 
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How to use SQL Developer 


To be able to develop effective triggers, you must understand the SQL and 
PL/SQL statements that are presented earlier in this chapter. However, once you 
understand these statements, SQL Developer provides some tools that can help 
you work with the triggers that you create. 


How to view, rename, or drop a trigger 


Figure 16-11 shows how to use SQL Developer to view, rename, and drop 
triggers. To start, you can view the triggers for a database by connecting to the 
database and expanding the appropriate folder. In this figure, I have expanded 
the Triggers folders so you can see all of the triggers that were presented in this 
chapter. If you take a moment to review these triggers, you can see that the 
naming convention that I've used throughout this chapter causes all triggers for 
a database object to be displayed next to each other. This makes it easy to see 
that there are five triggers defined on the Invoices table. 

Note that triggers can be stored in packages just as procedure and functions 
are stored in packages. As a result, if you want to view a trigger that's stored in 
a package, you must begin by expanding the package that contains the trigger. 

Once you've displayed a trigger, you can rename it or drop it by right- 
clicking on it and selecting the appropriate command. Then, you can use the 
resulting dialog box to provide a new name for the trigger or to confirm the 
drop. 

If you want to view the code for a trigger, you can do that by clicking on its 
name. Then, the code for the trigger will be displayed in the main window. In 
this figure, for example, I clicked on the trigger named invoices, after. dml to 
display it in the main window. 

To view other information about the trigger, click on one of the other tabs. 
For example, you can click on the Dependencies tab to view the database 
objects that this trigger depends on. Or, you can click on the Details tab to view 
other details about the trigger such as the date that the trigger was created. 

Although this figure shows how to view a trigger, you can't edit the trigger 
until you click on the Edit button in the toolbar. In this figure, I have positioned 
the mouse cursor over the Edit button and am about to click on it. When you 
click on this button, SQL Developer will display the trigger in an Edit window 
like the one shown in the next figure. 


How to enable or disable a trigger 


To enable or disable a trigger, right-click on its name in the Connections 
window and select the appropriate command. Then, you can use the resulting 
dialog box to confirm the action. 
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A trigger after it has been viewed in SQL Developer 


© oracle SOL Developer 
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Description 


e To view the triggers for a database, you can use SQL Developer to connect to the data- 
base. Then, you can expand the appropriate folder. 


e To drop a trigger, right-click on the trigger and select the Drop Trigger command. Then, 
use the resulting dialog box to confirm the drop. 


e To view the code for a trigger, click on its name. When you do, the code for the trigger 
will be displayed in the main window. 


e To view other information about a trigger, click on its name to display it in the main 
window. Then, click on one of the other tabs (Dependencies or Details) to get more 
information. 


e To edit a trigger, click on its name to display it in the main window. Then, click on the 
Edit button in the toolbar. 


Figure 16-11 How to view, rename, and drop triggers 
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How to edit a trigger 


When you execute a CREATE TRIGGER statement, Oracle automatically 
compiles the trigger. However, if the compiler detects errors, it will display 
these errors. At this point, you need to find the causes of the errors and fix them. 
To help you do that, you can open the trigger in an Edit window and compile the 
trigger again. 

When you compile a trigger that has errors, the compiler displays error 
messages that can help you identify the causes of the errors. In figure 16-12, for 
example, the Compiler — Log window shows an error message that indicates 
that the problem occurred when the compiler reached the first INSERT state- 
ment. If you look at this statement closely, you'll notice that the first IF state- 
ment should use the INSERTING predicate instead of the INSERT keyword. 

As a result, you can fix this problem by using the Edit window to edit the 
code. When you're done, you can click on the Compile button to recompile the 
code. If necessary, you can repeat the process until you get the code to compile 
cleanly. Then, you can test the code by executing a statement that causes the 
trigger to fire. 


How to debug a trigger 


Unfortunately, SQL Developer 1.5 doesn't provide the same debugger for 
triggers that it does for stored procedures and functions. As a result, you may 
need to use the time-tested technique of using the PUT LINE procedure of the 
DBMS, OUTPUT package to display the values of variables and other debug- 
ging information. 
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A trigger after it has been displayed in the Edit window 


Ё oracle SOL Developer 
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create or replace 
TRIGGER invoices after dnl 
AFTER IHSERT OR UPDATE OR DELETE 
UN invoices 
FUR EACH ROW 
H PAID 
B - IF INSERT THEW 
IHSERT INTO invoices audit VALUES 
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ELSIF UPDATING THEH 
INSERT INTO invoices audit VALUES 
(:old.vendor_id, :old.invoice_number, :old.invoice_total, 'UPDATED', S¥SIMMTE) 
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Description 
e To display a trigger in the Edit window, right-click on its name and select the Edit 
command. Or, after you display a trigger in the main window, click on the Edit button. 


e When a trigger is in the Edit window, you can edit the code that's stored in the database. 
To compile the trigger, you can click the Compile button in the toolbar. 

e Ifthe edited code contains errors when you compile it, SQL Developer will display the 
compile-time errors in a Compiler — Log tab at the bottom of the main window. 

e SQL Developer 1.5 doesn't provide a debugger for triggers. To debug a trigger, you can 
use the DBMS OUTPUT.PUT LINE statement to print the values of variables and other 
debugging information to the output window. 


Figure 16-12 How to edit a trigger 
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Perspective 


In this chapter, you learned how to use triggers to perform tasks that would be 


difficult or impossible to perform with other Oracle features like constraints. At 
this point, then, you should be able to create and use triggers that enforce data 
consistency, implement business rules, log changes to the database, and provide 
for updateable views. 


Although this is more than the typical application developer needs to know, 


this gives you the perspective that you need when you encounter the triggers that 
have been created by others. This also provides the background that you need for 
learning more about triggers on your own. 


Terms 


trigger 

fire a trigger 
statement-level trigger 
row-level trigger 
correlation identifier 
trigger predicate 
compound triggers 
mutating-table error 


Exercises 


1. 


Create a trigger named invoices before update payment for the Invoices table 
that raises an application error whenever the payment total plus the credit total 
becomes larger than the invoice total in a row. Then, test this trigger with an 
appropriate UPDATE statement. (Note that you could code a check constraint 
to accomplish the same task.) 


Create a trigger named invoices after update payment for the Invoices table 
that displays the vendor name, invoice number, and payment total in the output 
window whenever the payment total is increased. Then, test this trigger with an 
appropriate UPDATE statement. (À trigger like this could be modified so it 
stores the data in an audit table.) 


Use the script for figure 11-4 of chapter 11 to create an updateable view named 
balance, due view. Then, create and test an INSTEAD OF trigger named 
invoices instead оѓ insert that lets the user update the columns in the view by 
directly updating the Invoices table. Within this trigger, you can call the stored 
procedure named insert, invoice that's created by the script for figure 15-5 of 
chapter 15. 


Section 5 


Advanced data types 


This section presents some SQL skills for working with the data types that 
weren't presented in chapter 8. In chapter 17, you'll learn how to work with the 
TIMESTAMP and INTERVAL data types that were introduced with Oracle 9i. 
These data types make it easier to work with time zones and time intervals. 

In chapter 18, you'll learn how to work with the large object data types that 
were introduced with Oracle 8. These data types let you to store virtually any 
type of text or binary data within a database such as the data that's stored in text, 
XML, Word, PDF, image, sound, and video files. 
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How to work with 
timestamps and intervals 


In chapter 8, you learned how to work with the most common temporal data 
type, the DATE type. Now, this chapter expands on that coverage by showing 
how to work with the TIMESTAMP and INTERVAL data types that were 
introduced with Oracle 9i. Although the DATE type is adequate for working 
with most date/time values, the new data types make it easier to work with time 
zones and time intervals. 


An Introduction to time zones ..................... 0015020 DOL 
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Section 5 Advanced data types 


An introduction to time zones 


When client applications from multiple time zones access the same data- 
base, you need to handle the different time zones when you store a time in the 
database. Prior to Oracle 9i, Oracle only provided the DATE type for storing 
times, and this data type doesn't support time zones. As a result, the client 
application needed to handle the time zone by converting the local time zone to 
the database time zone. 

With Oracle 9i, however, Oracle provides features for working with time 
zones. Before you learn how to use them, though, this chapter introduces you to 
some terms and concepts for working with time zones, and it shows you how to 
change the default date format and the default time zone. 


Database time zone vs. session time zone 


Figure 17-1 introduces some concepts for working a time zone, which is an 
offset from the time in Greenwich, England. That time zone is known as Green- 
wich Mean Time (GMT) or Coordinated Universal Time (UTC). 

When you use Oracle to work with time zones, you can specify a time zone 
by coding an offset from GMT. To specify a time zone offset, you can code 
values like the ones at the top of this figure. For example, the first offset is one 
hour ahead of GMT, and the second offset is one hour behind GMT. 

You can also specify a time zone by coding its name or abbreviated name. 
To look up time zones from around the world, you can code a SELECT state- 
ment like the first one in this figure. Here, the result set shows that Pacific 
Standard Time has a name of US/Pacific or US/Pacific-New and many possible 
abbreviations. Of these abbreviations, PST and PDT are the most common. 

When you use Oracle to work with time zones, the session time zone is the 
time zone for the current session. For example, when start SQL Developer, you 
start a session. Conversely, when you exit SOL Developer, you end a session. If 
you want to view the time zone offset for a session, you can use the 
SESSIONTIMEZONE function. For example, when I ran the second SELECT 
statement in this figure, this function returned an offset of -7:00 because I am in 
California, which has an offset of -7:00 or -8:00, depending on whether it is 
daylight savings. In this case, it is summer, so this function returns an offset of 
-7:00. This shows that Oracle automatically adjusts for daylight savings time. 

When you use Oracle to work with time zones, the database time zone is the 
time zone for the current database. Typically, the database time zone is set 
correctly when you install Oracle. However, if the database time zone isn't set 
correctly you can use the ALTER DATABASE command to change it. To view 
the database time zone, you can use the DBTIMEZONE function. For example, 
when I ran the third SELECT statement in this figure, this function returned an 
offset of +00:00. This offset indicates that the database is using the same time 
zone as the operating system for the database server. 
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Time zone offsets 


+01:00 
-01:00 
402100 
-02:00 


How to view time zone names 
SELECT * FROM v$timezone names 


The result set 


@ TzNAME ü TZABBREV 

RET ү 

1384 US/Mountain LMT 

1365 US/Mountain MST 

1366 USmMountain MNT 

1387 US/Mountain MDT 

1368 USPacific LMT 

1388 US/Pacttle PST 

1370 USPacitle PT 

1371 USPacitle PDT 

1372 USPacitic-New LMT 

1373 USPacitic-New PST 

1374 USPacitic-New PANT 

1375 US/Pacitic-New PDT 

1378 USSamoa LMT J 
w 


How to view the default session time zone 
SELECT SESSIONTIMEZONE FROM dual 


The result set 
-07:00 


How to view the default database time zone 
SELECT DBTIMEZONE FROM dual 


The result set 
+00:00 


Description 


e A time zone is an offset from the time in Greenwich, England. The time zone in Green- 
wich England is known as Greenwich Mean Time (GMT) or Coordinated Universal Time 


(UTC). 
e А time zone can be stored as an offset or as a region name or abbreviation. 
e The session time zone is the time zone for the current session. 
e The database time zone is the time zone for the current database. 


Figure 17-1 An introduction to time zones 
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How to change the default date format 


By default, Oracle uses the DD-MON-RR format for date/time values. 
However, to make it easier to work with date/time values that are in other 
formats, you can use the ALTER SESSION statement to change the default date 
format for the current session. If, for example, you are working with dates that 
include time values, it makes sense to change the default date/time format so it 
includes time values as shown in figure 17-2. 

Here, the first example changes the default date format so it includes 
HH:MM and AM or PM in the time portion of a date/time value. Then, the 
second example uses this format to insert a DATE value. Since the string literal 
for the DATE value that's supplied by this INSERT statement uses the newly set 
date/time format, you don't have to use the TO. DATE function to convert this 
string literal to a DATE value. Finally, the third example shows that the newly 
set date/time format is used by the result set to display the date/time values. 


How to change the default time zone 


The rest of the statements in this figure show how to use the ALTER SES- 
SION statement to change the time zone for the session. Here, the first two 
statements in the fourth example use keywords to change the time zone for the 
session. The first statement sets the time zone to the time zone that's used by the 
operating system, and the second statement sets the time zone to the time zone 
that's used by the database. Most of the time, these two time zones are the same. 

The last three statements in this figure use offsets and time zone names to 
set the time zone to the Mountain Time Zone in the United States. Here, the 
Offset is -06:00 because that's the offset for this time zone during daylight 
savings time. However, during the winter months, the offset is -07:00. 


Session settings vs. database settings 


When you change settings for the session, the settings are temporary and 
only apply to the current session. As a result, if you want to reset all settings to 
their default values, you can do that by ending the session and starting a new 
one. To do that with SQL Developer or SQL*Plus, you can exit the program and 
restart it. 

If you want to permanently change the date format or time zone settings, 
you can use the ALTER DATABASE statement instead of the ALTER SESSION 
statement. Since the ALTER DATABASE statement works much like the 
ALTER SESSION statement, you shouldn't have any trouble using it. Of 
course, to do this, you must log on as a user that has the appropriate privileges 
to alter the database. 
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А statement that changes the date format for the session 
ALTER SESSION SET NLS DATE FORMAT s 'DD-MON-RR HH:MI АМ! 


An INSERT statement after the date format has been changed 
INSERT INTO date sample VALUES (7, '02-MAR-08 09:02 AM') 


A SELECT statement after the data format has been changed 


SELECT * FROM date sample 


The result set 
Д рате Б єтднт_рдтЕ 


1 01-MaR-78 12:00 АМ ^ 
2 28-РЕВ-99 12:00 АМ 

3 31-OCT-03 12:00 АМ 

4 28-FEB-05 10:00 АМ 

5 28-РЕВ-06 01:58 PM 

В 01-МАК-ОБ 09:02 АМ 

7 02-MAR-068 09:02 АМ 
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Statements that use keywords to change the time zone for the session 


ALTER SESSION SET TIME ZONE LOCAL 
ALTER SESSION SET TIME ZONE DBTIMEZONE 


Statements that change the time zone for the session 


ALTER SESSION SET TIME ZONE = -06:00 
ALTER SESSION SET TIME ZONE s 'MST' 
ALTER SESSION SET TIME ZONE = 'US/Mountain' 


Description 


e You can use the ALTER SESSION statement to change the default date format or time 
zone for the current session. 


e If you change any settings for the session, you can reset all settings by ending the session 
and starting a new one. 


e You can use the ALTER DATABASE statement to permanently change the date format 
or time zone. 


Figure 17-2 How to set the default date format and time zone 
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How to use functions to work with time zones 


In chapter 8, you learned how to work with the SYSDATE and 
CURRENT DATE functions. Now, figure 17-3 reviews the use of these func- 
tions and shows how to use some of the functions for working with time zones. 

To start, note that the SYSDATE and CURRENT. DATE functions usually 
return the same DATE value. However, if the time zone has been changed for 
the session, the CURRENT, DATE function will adjust the DATE value accord- 
ingly. 

As you learned earlier, you can use the DBTIMEZONE function to return 
an offset for the database time zone relative to the operating system time zone. 
similarly, you can use the SESSIONTIMEZONE function to return an offset for 
the session time zone relative to the UTC time zone. 

In addition, you can use ће TZ, OFFSET function to return a time zone 
Offset for the specified time zone. When you use this function, you can specify 
the name of the time zone or the abbreviation for the time zone. Note that this 
function automatically adjusts for daylight savings time. This causes the results 
shown in this figure to be different during the winter months. 

Finally, you can use the NEW TIME function to convert a DATE value 
from one time zone to another. In this figure, for instance, the last three ex- 
amples show how to convert the current date from Pacific Standard Time (PST) 
to Mountain Standard Time (MST), Central Standard Time (CST), and Eastern 
Standard Time (EST). 
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Some common functions for working with time zones 


SYSDATE Returns the current local date and time based on the 
operating system's clock. 
CURRENT DATE Returns the local date and time adjusted for the current 


session time zone. 
Returns the time zone offset for the database. 


DBTIMEZONE 


SESSIONTIMEZONE Returns the time zone offset for the session. 
TZ OFFSET(time zone) Returns the offset in hours for the specified time zone. 
NEW TIME(date, zonel, zone2) Converts the specified date from the first specified time 


zone to the second time zone. 


Examples that use functions to work with time zones 


SYSDATE 19-AUG-08 04:20 PM 
CURRENT DATE 19-AUG-08 04:20 PM 
DBTIMEZONE +00:00 
SESSIONTIMEZONE 'America/Los Angeles' 
TZ OFFSET('AMERICA/LOS ANGELES!) -07:00 

TZ OFFSET('PST') -07:00 

TZ OFFSET('MST!) -06:00 

TZ OFFSET('CST!) -05:00 

TZ OFFSET('EST!) -04:00 


NEW TIME(CURRENT DATE,'PST!,'MST') 19-AUG-08 05:20 PM 
NEW TIME(CURRENT DATE,'PST','CST') 19-AUG-08 06:20 PM 
МЕЙ ТІМЕ (CURRENT_DATE, 'PST', 'EST') 19-AUG-08 07:20 PM 


Figure 17-3 How to use functions to work with time zones 
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How to work with timestamps 


Now that you understand how time zones work, you're ready to learn how 
to work with the TIMESTAMP types that were introduced with Oracle 9i. These 
data types provide two advantages over the DATE type. First, they make it 
easier to work with time zones. Second, they allow you to store fractional 
seconds. 


An introduction to the TIMESTAMP types 


Figure 17-4 lists the three TIMESTAMP types. Here, the TIMESTAMP type 
works much like the DATE type, except that it allows you to store fractional 
seconds. When you specify a TIMESTAMP type, you can specify a value of 0 
to 9 to set the fractional second precision, which is the number of decimal 
places that Oracle uses for fractional seconds. Or, if you don't specify the 
fractional second precision, Oracle will use a default value of 6. 

The TIMESTAMP WITH LOCAL TIME ZONE type works much like the 
TIMESTAMP type. However, when a date/time value is stored in a column of 
this data type, Oracle automatically converts the date/time value from the 
session time zone to the database time zone. Conversely, when a date/time value 
is retrieved from a column of this type, Oracle automatically converts the date/ 
time value from the database time zone to the session time zone. Since Oracle 
automatically handles these conversions, this data type makes it easy to work 
with time zones. 

The TIMESTAMP WITH TIME ZONE type works like the TIMESTAMP 
type, except that it actually stores a time zone name, abbreviation, or offset in 
the database. That's why it requires more storage space than the other two 
TIMESTAMP types. 


The TIMESTAMP types 
TIMESTAMP[(fsp)] 740211 
ТІМЕЗТАМР [(Ёвр)] 7 to 11 


WITH LOCAL TIME ZONE 


TIMESTAMP [(fsp)] 13 
WITH TIME ZONE 


Description 
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An extension of DATE. Stores year, month, day, hour, 
minute, second, and (optionally) the fractional part of a 
second where the fractional second precision (fsp) is the 
number of decimal places used to store the fractional 
second. This type does not have a time zone. 

Works like TIMESTAMP except that the time zone 

is set to the database time zone when it is stored in the 
database, and it's set to the session time zone when the data 
is retrieved. 

Works like TIMESTAMP except that it includes 

either a time zone name, abbreviation, or offset. 


e The default value for fractional second precision is 6. 


e All precision parameters for fractional seconds accept values of 0 to 9. 


Figure 17-4 Тһе TIMESTAMP types 


539 


540 Section 5 Advanced data types 


How to work with the TIMESTAMP type 


Figure 17-5 shows how to work with the TIMESTAMP type. To start, the 
first example shows how to create a table named Downloads that stores data of 
the TIMESTAMP type. Here, the first column in the table contains a NUMBER 
value that uniquely identifies each download. Then, the second column in the 
table contains a TIMESTAMP value that stores the exact time of the download. 

The second example shows a script that inserts three rows into the table. 
Here, the first INSERT statement specifies a literal value for a timestamp by 
coding the TIMESTAMP keyword followed by a timestamp value enclosed in 
single quotes. Note that this INSERT statement uses the default format to 
specify the TIMESTAMP literal. Note also that this format is different than the 
default format that's used to display a TIMESTAMP value. 

The second INSERT statement also uses the TIMESTAMP keyword to 
specify a literal value for a timestamp. In contrast, the third INSERT statement 
uses the CURRENT_TIMESTAMP function to return a TIMESTAMP WITH 
TIME ZONE value for the current time. However, this value is automatically 
converted to a TIMESTAMP value before it’s inserted into the table. Finally, the 
COMMIT statement commits the changes to the database. 

The third example shows a SELECT statement that retrieves all data from 
the table. The result set that’s returned by this SELECT statement shows that the 
fractional seconds are rounded to the precision that’s specified by the CREATE 
TABLE statement. For example, the second INSERT statement contains seven 
digits for the fraction second portion of the TIMESTAMP value. However, the 
CREATE TABLE statement specifies a precision of six digits. As a result, these 
seven digits are rounded to six digits before they are stored in the database. 

Note that the CURRENT TIMESTAMP function in this figure only returns 
three digits for the fractional seconds of the TIMESTAMP value. Аз a result, 
this value doesn't need to be rounded before it's stored in the database. How- 
ever, on some systems, the CURRENT. TIMESTAMP function may return 
more digits for the fractional seconds. In that case, this value will be rounded to 
the specified precision before it's stored in the database. 
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A table that uses the TIMESTAMP type 


CREATE TABLE downloads 

( 
download id NUMBER PRIMARY KEY, 
download timestamp  TIMESTAMP (6) 

): 


A script that inserts three TIMESTAMP values into a table 


INSERT INTO downloads 
VALUES (1, TIMESTAMP '2008-08-15 16:20:47.123456!); 


INSERT INTO downloads 
VALUES (2, TIMESTAMP '2008-08-15 16:20:47.1234567'); 


INSERT INTO downloads 
VALUES (3, CURRENT_TIMESTAMP (6) ) ; 


COMMIT; 


A statement that retrieves the TIMESTAMP values 


SELECT * FROM downloads; 


The result set 
pownLoap_p |g DOWNLOAD. TIMESTAMP 


1 1 15-4UG-08 04.20.47 1 23455000 РМ ^ 
2 15-ALIG-08 04.20.47 1 23457000 РМ 


3 18-ALIG-D8 04.20.53. 265000000 РМ 


The default format for specifying a TIMESTAMP literal 


TIMESTAMP 'YYYY-MM-DD HH24:MI:8SS.FF9' 


The default format for returned TIMESTAMP values 


DD-MON-RR HH.MI.SS.FF9 AM 


Description 


e To specify a literal value for a timestamp, code the TIMESTAMP keyword followed by a 
literal value enclosed in single quotes as shown above. 

e If the fractional seconds are longer than the precision for the TIMESTAMP, they will be 
rounded to the nearest fractional second. 


e Тһе CURRENT TIMESTAMP function returns a TIMESTAMP WITH TIME ZONE 
value for the current data and time in the session time zone (see figure 17-9). 


Figure 17-5 How to work with the TIMESTAMP type 
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How to work with the TIMESTAMP WITH LOCAL 
TIME ZONE type 


Figure 17-6 shows how to work with the TIMESTAMP WITH LOCAL 
TIME ZONE type. The main difference between this and working with the 
TIMESTAMP type is that Oracle automatically adjusts the time zone so it's 
transparent to the users of the database. 

When a user inserts data, the database converts the session time zone to the 
database time zone. In addition, if a user specifies a time zone name or offset in 
a TIMESTAMP literal, Oracle automatically converts the timestamp to the 
database time zone before it stores its value. In this figure, for example, the first 
INSERT statement specifies the PST time zone, the second specifies the EST 
time zone, and the third specifies an offset of -7:00, which is the offset for the 
PST time zone during daylight savings time. Then, the fourth INSERT state- 
ment uses the CURRENT. TIMESTAMP function to insert a timestamp for the 
current session. 

Conversely, when a user retrieves data from the database, the database 
converts the database time zone to the session time zone. In this figure, for 
example, the result set shows a time of 4:20 for all of the rows for the PST time 
zone and a time of 1:20 for the EST time zone. This makes it easy to see that the 
EST time zone is three hours earlier than the PST time zone. 
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A table that uses the TIMESTAMP WITH LOCAL TIME ZONE type 


CREATE TABLE downloads 162 

( 
download id NUMBER PRIMARY KEY, 
download timestamp TIMESTAMP WITH LOCAL TIME ZONE 

)1 


A script that inserts four TIMESTAMP WITH LOCAL TIME ZONE values 


INSERT INTO downloads 162 
VALUES (1, TIMESTAMP '2008-08-15 16:20:47.123456 PST'); 


INSERT INTO downloads 162 
VALUES (2, TIMESTAMP '2008-08-15 16:20:47.123456 EST'); 


INSERT INTO downloads 162 
VALUES (3, TIMESTAMP '2008-08-15 16:20:47.123456 -7:00'); 


INSERT INTO downloads 162 
VALUES (4, CURRENT TIMESTAMP); 


COMMIT; 


А statement that retrieves the TIMESTAMP values 


SELECT * FROM downloads 162; 


The result set 


Y DOWNLOAD ДО DOWNLOAD, TIMESTAMP 
4 15-AUG-08 04.20.47 123456000 PM 
2 15-AUG-08 01.20.47 123456000 PM 


315-405-080 04.20.47 1 23455000 РМ 
4 19-ALU/G-08 04.20.57 828000000 PM 


Description 


e When a user inserts data, the database converts the session time zone to the database 
time zone. 


e When a user retrieves data from the database, the database converts the database time 
zone to the session time zone. 


Figure 17-6 Ном to work with the TIMESTAMP WITH LOCAL TIME ZONE type 
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How to work with the TIMESTAMP WITH TIME 
ZONE type 


Figure 17-7 shows how to work with the TIMESTAMP WITH TIME ZONE 
type. Unlike the previous two TIMESTAMP types, the TIMESTAMP WITH 
TIME ZONE type actually stores the time zone in the database. 

When you store data for this type, the time zone name or offset that you 
specify is stored in the database. In this figure, for example, the first three 
INSERT statements all specify Pacific Standard Time. The first INSERT 
statement uses a full name, the second uses an abbreviation, and the third uses 
an offset of -7:00, which is the same as the PST time zone during daylight 
savings. Then, the fourth INSERT statement uses an abbreviation for Easter 
Standard Time, and the fifth INSERT statement uses the CURRENT TIMESTAMP 
function to insert a timestamp for the current session. 

If you don't specify a time zone, an offset for the session time zone is stored 
in the database. In this figure, for example, the session time zone is Pacific 
Standard Time, and it is daylight savings time. As a result, if you don't specify a 
time zone, an offset of -7:00 is stored in the database. 

When you retrieve data from this type, the result set includes the time zone. 
If you specify a name or abbreviation for a time zone, the name or abbreviation 
is returned. However, UTC is used for all time zone abbreviations except for the 
current database time zone. That's why the fourth row in the result set returns 
the time as UTC instead of EST. Note also that UTC doesn't account for 
daylight savings time. Аз a result, there's a four hour difference between the 
first row and the third row instead of a three hour difference. Later in this 
chapter, you'll learn how to format the data that's retrieved so it takes daylight 
savings into account. 
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A table that uses the TIMESTAMP WITH TIME ZONE type 


CREATE TABLE downloads tz 

( 
download id NUMBER PRIMARY KEY, 
download timestamp  TIMESTAMP WITH TIME ZONE 

); 


A script that inserts four TIMESTAMP WITH TIME ZONE values 


INSERT INTO downloads tz 
VALUES (1, TIMESTAMP '2008-08-15 16:20:47.123456789 PST'); 


INSERT INTO downloads tz 
VALUES (2, TIMESTAMP '2008-08-15 16:20:47.123456 US/Pacific'); 


INSERT INTO downloads tz 
VALUES (3, TIMESTAMP '2008-08-15 16:20:47.123456 -7:00'); 


INSERT INTO downloads tz 
VALUES (4, TIMESTAMP '2008-08-15 16:20:47.123456 EST'); 


INSERT INTO downloads tz 
VALUES (5, CURRENT_TIMESTAMP) ; 


COMMIT; 


A statement that retrieves the TIMESTAMP values 


SELECT * FROM downloads tz; 


The result set 


B powwLoap i|] pownLoaD_TIMESTAMP 
1 15-AUG-08 04.20.47 123457000 PM PST ^ 
2 15-AUG-08 04.20.47 123458000 PM US/PACIFIC 

3 15-AUG-08 04.20.47 123456000 PM -07:00 
4 15-AUG-08 08.20.47 123458000 PM UTC 

5 19-AUG-08 04.21.04.312000000 PM -07:00 


on fF бу һу — 


Description 


e This data type works the same as the TIMESTAMP type, but it includes a time zone after 


the fractional seconds. 


e UTC is used for all time zone abbreviations except for the current database time zone. 


Figure 17-7 How to work with the TIMESTAMP WITH TIME ZONE type 
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Common format elements for timestamps 


Figure 17-8 summarizes the most common format elements for timestamps 
and provides some examples that show how to use format elements to specify 
fractional seconds and time zones. If you study these examples, you shouldn't 
have much trouble understanding how they work. 
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Common format elements for timestamps 
Element Description 


Fractional seconds. 

Time zone hour offset. 
Time zone minutes offset. 
Time zone region. 


Time zone with daylight savings. 


Time formats that use fractional seconds and time zones 
Format Example 
HH:MI:88.FF AM 04:20:36.123456 PM 
HH:MI:88.FF3 AM 04:20:36.123 PM 


HH:MI:SS.FF9 AM TZH:TZM 04:20:36.123456000 PM -07:00 
HH:MI:88.FF9 AM TZR 04:20:36.123456789 PM PST 
HH:MI:88.FF9 AM TZD 04:20:36.123456789 PM PDT 


Description 


e For more information about date/time format elements, look up “Datetime Format 
Elements" in the Oracle Database SQL Language Reference. 


Figure 17-8 Common format elements for timestamps 
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How to use functions to work with timestamps 


Part 1 of figure 17-9 shows some of the common functions for working with 
timestamps. To start, you can use the first three functions to return a 
TIMESTAMP or TIMESTAMP WITH TIME ZONE value. When you use these 
functions, you can the fractional second precision parameter to control the maxi- 
mum number of fractional seconds that are returned by the function. Or, if you 
omit this parameter, the default is 6. However, the maximum number of fractional 
seconds may be limited by the system clock on the computer that's hosting the 
database. On my system, for example, these functions only return 3 fractional 
seconds. 

The first four examples in this figure show how to use the functions that 
return a timestamp for the current time. Here, the SYSTIMESTAMP function 
returns a timestamp with a time zone offset. The CURRENT. TIMESTAMP 
function returns a timestamp with a time zone name. The LOCALTIMESTAMP 
function returns a timestamp that doesn't include the time zone portion of the 
timestamp. And the second SYSTIMESTAMP function specifies a fractional 
second precision of 2 so the fractional seconds for this timestamp are rounded to 2 
decimal places. 

The last three examples show how to use the FROM, TZ and 
SYS EXTRACT. UTC functions. Here, the FROM, TZ function converts the 
current timestamp from the PST time zone to the EST time zone. Note that this 
function returns the newly converted timestamp with the UTC time zone. Then, 
the two SYS EXTRACT. UTC functions convert two different timestamps to the 
UTC time zone. 

Although it isn't shown in this figure, you can also use the EXTRACT func- 
tion to extract a year, month, day, hour, minute, or second from a DATE or 
TIMESTAMP value. To do that, you use the YEAR, MONTH, DAY, HOUR, 
MINUTE, and SECOND keywords to specify the part of the data that you want to 
extract. For example, if you want to extract the year from the TIMESTAMP 
values stored in the Downloads table that was created in figure 17-5, you can use 
a statement like this: 


SELECT EXTRACT(YEAR FROM download timestamp) AS download year 
FROM downloads; 


You can also use the TIMEZONE HOUR, TIMEZONE , MINUTE, 
TIMEZONE, REGION, and TIMEZONE ABBR keywords to extract the time 
zone offset, region name, or region abbreviation. For example, if you want to 
extract the hour offset for a time zone, you can use a statement like this: 


SELECT EXTRACT(TIMEZONE HOUR FROM download timestamp) AS tz hour 
FROM downloads tz; 


However, this only works if the value has been stored as a TIMESTAMP WITH 
TIME ZONE value. That's why this statement selects data from the 
Downloads TZ table that was created in figure 17-7. 
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Common functions for working with timestamps 


SYSTIMESTAMP ( [fsp] ) 
CURRENT TIMESTAMP ( [fsp] ) 


LOCALTIMESTAMP ( [fsp] ) 


FROM_TZ (timestamp, time_zone) 


ЗҮЗ ЕХТКАСТ ОТС (timestamp) 


TO TIMBSTAMP(expr[, Ёшї]) 


TO TIMESTAMP TZ(expr[, fmt]) 


Returns a TIMESTAMP WITH TIME ZONE value for 
the current date and time in the database time zone. 


Returns a TIMESTAMP WITH TIME ZONE value for 
the current date and time in the session time zone. 


Returns a TIMESTAMP value for the current date and 
time in the session time zone. 


Converts a TIMESTAMP value and a time zone to a 
TIMESTAMP WITH TIME ZONE value. 


Extracts the UTC time from a TIMESTAMP value with 
a time zone offset or time zone region name. 


Converts the result of an expression to a value of the 
TIMESTAMP type. 


Converts the result of an expression to a value of the 
TIMESTAMP WITH TIME ZONE type. 


Examples that use functions to work with timestamps 


SYSTIMESTAMP 
CURRENT TIMESTAMP 
LOCALTIMESTAMP 
SYSTIMESTAMP (2) 


FROM TZ(LOCALTIMESTAMP, 'EST') 


SYS EXTRACT UTC(SYSTIMESTAMP) 
8YS EXTRACT UTC(CURRENT TIMESTAMP) 


Description 


19-AUG-08 04.20.16.906000000 PM -07:00 


19-AUG-08 04.20.16.906000000 PM PST 


19-AUG-08 04.20.16.906000000 PM 


19-AUG-08 04.20.16.910000000 PM -07:00 


19-AUG-08 08.20.16.906000000 PM UTC 


19-AUG-08 11.20.16.906000000 PM 
19-AUG-08 11.20.16.906000000 PM 


e If you omit the fractional second precision (fsp) parameter, the default is 6. 

e You сап also use the EXTRACT function to extract a year, month, day, hour, minute, 
second, or time zone from a DATE or TIMESTAMP value. 

e These examples assume that current date and time is August 19 2008 at 
04:20:16.906000000 PM Pacific Standard Time with daylight savings. 


e The maximum number of fractional seconds that's returned by the TIMESTAMP func- 
tions is determined by the system on which the database resides. On many systems, the 
TIMESTAMP functions returns only 3 fractional seconds. 


Figure 17-9 Ном to use functions to work with timestamps (part 1 of 2) 
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Part 2 of figure 17-9 presents some more examples that show how to use the 
functions presented in part 1. These examples show that you can test these 
functions within a SELECT statement that selects data from the Dual table. 

The first example shows how to use the TO TIMESTAMP function to 
convert a string literal for a timestamp to a TIMESTAMP value. To do that with 
one parameter, you can specify the TIMESTAMP value in the default format as 
shown in the first statement. Or, you can use a second parameter to specify the 
format of the timestamp as shown in the second statement. Either way, the value 
that's returned is the same. 

The second example shows how to use the TO TIMESTAMP TZ function 
to convert a string literal for a timestamp to a TIMESTAMP WITH TIME 
ZONE value. This works much like the TO TIMESTAMP function except that 
you can specify a time zone for this function. 

The third example shows how to use the TO CHAR function to format the 
TIMESTAMP WITH TIME ZONE value that's returned by the 
CURRENT TIMESTAMP function. Note that this function formats the 
timestamp so it displays 9 digits for the fractional seconds. In addition, it uses 
the TZR format to display the PST abbreviation for the time zone region. 

The fourth example shows how to use the TO CHAR function to format the 
TIMESTAMP WITH TIME ZONE values that were stored in the 
Downloads TZ table that was created in figure 17-7. Since this format uses the 
TZD format element to format the time zone values for daylight savings time, 
this table uses the PDT abbreviation for Pacific Standard Time instead of PST, 
and it uses the EDT abbreviation for Eastern Standard Time instead of EST. In 
addition, it doesn't return a time zone for the third and fifth rows, which have 
values that use time zone offsets instead of time zone names. 

At first, you may find these examples to be a little confusing. However, with 
a little experimentation and practice, you should be able to use these functions 
to get the timestamps in your database to work the way you want them to work. 
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How to convert a string to a TIMESTAMP value 


SELECT TO TIMESTAMP('15-AUG-08 4:20:47.123456 PM') 
FROM dual; 


SELECT TO ТІМЕЗТАМР ('2008-08-15 4:20:47.123456 PM', 


'YYYY-MM-DD HH:MI:SS8.FF6 AM!) 
FROM dual; 


Result set 


TO_TIMESTAMP('2008-06-154: 20:47 1 23456PM' ^s? - WW-DDHHB: MESS. FFEAM"] | 


1 15-4060-08 04.20.47 123456000 РМ 


<> 


How to convert a string to a TIMESTAMP WITH TIME ZONE value 


SELECT TO TIMESTAMP TZ ('15-AUG-08 4:20:47.123456 PM PST!) 
FROM dual; 


SELECT TO TIMESTAMP TZ('2008-08-15 16:20:47.123 PST', 


'YYYY-MM-DD HH24:MI:8S.FF6 TZR!) 
FROM dual; 


Result set 


TO_TIMEST AMP TZI('2008-08-15165; 20: 4741 23456PST' ^^v Mw DDHH24: MESS FFETZR' 
1 15-ALIG-ü8 04 20.47 123456000 РМ PST 


<> 


A SELECT statement that formats a timestamp 


SELECT TO CHAR(CURRENT TIMESTAMP, 'DD-MON-RR HH:MI:SS.FF9 AM TZR') 
AS time zone test 
FROM dual; 


Result set 


TIME ZONE TEST | 


1 19-41-08 04:22: 47 734000000 РМ PST 


<> 


Another SELECT statement that formats a timestamp 


SELECT TO CHAR(transaction timestamp, 'DD-MON-RR HH:MI:88.FF AM TZD') 
AS download timestamp 
FROM timestamp tz sample; 


Result set 


DOWNLOAD. TIMESTAMP 
1 15-05-08 04:20:47 123457 PM PDT ^ 
2 15-ALIG-DB 04:20:47 123458 PM PDT 
3 15-ALIG-DB 04:20:47.123458 РМ 


4 16-4UG-08 04:20:47,123456 PM EDT 
5 18-ALUG-08 04:21:04,312000 PM 


Figure 17-9 How to use functions to work with timestamps (part 2 of 2) 
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How to work with intervals 


The INTERVAL types were introduced with Oracle Database 9i. These data 
types make it easier to work with time intervals like 2 days, 2 hours, and 12 
minutes. Before these data types were introduced, it was common to use the 
NUMBER type to store intervals of time. 


An introduction to the INTERVAL types 


Figure 17-10 lists the three INTERVAL types. Here, the INTERVAL YEAR 
TO MONTH type stores a time interval in years and months. For example, you 
can store an interval of 1 year and 3 months. When you use this type, you can 
specify a value from 0 to 9 for year precision, which is the number of digits that 
Oracle uses to store the years. By default, this value is set to 2, which allows 
you to store a maximum of 99 years. 

The INTERVAL DAY TO SECOND type stores a time interval in days, 
hours, minutes and seconds. When you use this type, you can specify a value 
from 0 to 9 for the day precision, which is the maximum number of digits that 
Oracle uses to store the days. By default, this value is set to 2, which allows you 
to store a maximum of 99 days. In addition, you can specify fractional second 
precision. This works the same as fractional seconds for the TIMESTAMP 


types. 
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The INTERVAL types 


Description 


INTERVAL YEAR [(yp)] Stores a time interval in years and months. Year 
TO MONTH precision (yp) is the number of digits in the year, and the 
default is 2. 


INTERVAL DAY [(dp)] Stores a time interval in days, hours, minutes and 
TO SECOND [(fsp)] seconds. Day precision (dp) is the maximum number of digits 
in the day, and the default is 2. Fractional second precision 
(fsp) is the maximum number of digits for fractional seconds, 
and the default is 6. 


INTERVAL YEAR TO MONTH units 


YEAR 
MONTH 


INTERVAL DAY TO SECOND units 


DAY 
HOUR 
MINUTE 
SECOND 


Description 


e You can use the INTERVAL types to store intervals of time in years, months, days, 
hours, minutes, seconds, and fractional seconds. 


e All precision parameters accept values of 0 to 9. 


Figure 17-10 The INTERVAL types 
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How to work with the INTERVAL YEAR TO 
MONTH type 


Figure 17-11 shows how to work with the INTERVAL YEAR TO MONTH 
type. To start, the first example shows how to create a table named 
Interval YM, Sample that stores data of this type. Here, the first column in the 
table specifies а NUMBER value that uniquely identifies each row. Then, the 
second column in the table specifies an INTERVAL YEAR TO MONTH value 
with a year precision of 3. Аз a result, you can store a value with a maximum of 
999 years or a minimum of -999 years. 

The second example shows a script that inserts six rows into the table. Here, 
the first INSERT statement specifies a year by coding the INTERVAL keyword, 
followed by a literal value for the year enclosed in single quotes, followed by 
the YEAR keyword. The second statement specifies a literal value for a month 
by coding the INTERVAL keyword, followed by a literal value for the month, 
followed by the MONTH keyword. The third statement works like the second 
one, except that it specifies a month value that's greater than 12 to show how 
Oracle handles this situation. The fourth statement specifies a year and a month 
by coding the INTERVAL keyword, followed by a literal value for the year and 
month, followed by the YEAR TO MONTH keywords. The fifth statement 
works like the fourth one, except that it specifies a negative value. Finally, the 
sixth statement specifies a year with a precision of 3 by coding the precision 
after the YEAR keyword for the literal value. Note that this works because the 
table allows a year precision of 3. 

The third example shows a SELECT statement that retrieves all data from 
the table. The result set that's returned by this SELECT statement shows that a 
value of 0 is added to the month portion of year values that don't include month 
values. Similarly, it shows that a value of 0 is added to the year portion of 
month values that don't include a year. In addition, it shows that month values 
that are greater than 12 are converted into an equivalent year and month value. 
That's why the values for the third and fourth rows are the same. Finally, it 
shows that a minus sign is used to display negative interval values. 
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A table that uses the INTERVAL YEAR TO MONTH type 


CREATE TABLE interval ym sample 

( 
interval id NUMBER PRIMARY KEY, 
interval value INTERVAL YEAR(3) TO MONTH 

); 


А script that inserts INTERVAL values 


INSERT INTO interval ym sample 
VALUES (1, INTERVAL '1' YEAR); 


INSERT INTO interval ym sample 
VALUES (2, INTERVAL '3' MONTH); 


INSERT INTO interval ym sample 
VALUES (3, INTERVAL '15' MONTH); 


INSERT INTO interval ym sample 
VALUES (4, INTERVAL '1-3' YEAR TO MONTH); 


INSERT INTO interval ym sample 
VALUES (5, INTERVAL '-1-3' YEAR TO MONTE) ; 


INSERT INTO interval ym sample 
VALUES (6, INTERVAL '100' YEAR(3)); 


COMMIT; 


А statement that retrieves INTERVAL values 
SELECT * FROM interval ym sample 


The result set 


INTERVAL D INTERVAL. ALUE 


Description 


e To specify a literal value for an interval, code the INTERVAL keyword followed by a 
literal value enclosed in single quotes followed by the YEAR, MONTH, or YEAR TO 
MONTH keywords that correspond with the literal value. 


Figure 17-11 Ном to work with the INTERVAL YEAR TO MONTH type 
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How to work with the INTERVAL DAY TO SECOND 
type 


Figure 17-12 shows how to work with the INTERVAL DAY TO SECOND 
type. This is much like working with the INTERVAL YEAR TO MONTH type 
as in the previous figure. The main difference is that you can use four keywords 
(DAY, HOUR, MINUTE, and SECOND) to work with the four components of 
the INTERVAL DAY TO SECOND type. You can also use fractional seconds 
when you're working with the second component. 


Chapter 17 


How to work with timestamps and intervals 


A table that uses the INTERVAL DAY TO SECOND type 


CREATE TABLE interval ds sample 
( 
interval id 
interval value 
); 


NUMBER 


A script that inserts INTERVAL values 


INSERT INTO interval ds sample 
VALUES (1, INTERVAL '1' DAY); 


INSERT INTO interval ds sample 
VALUES (2, INTERVAL '4' HOUR); 


INSERT INTO interval ds sample 
VALUES (3, INTERVAL 


INSERT INTO interval ds sample 
VALUES (4, INTERVAL '31' 


INSERT INTO interval ds sample 
VALUES (5, INTERVAL !'31.45' 


INSERT INTO interval ds sample 
VALUES (6, 


INSERT INTO interval ds sample 
VALUES (7, INTERVAL 


INSERT INTO interval ds sample 
VALUES (8, INTERVAL 


COMMIT; 


А statement that retrieves INTERVAL values 


INTERVAL '1 4:20:31.45' 


'-1 4:20:31. 


1100 4:20:31.45' 


'20' MINUTE); 


SECOND) ; 


SECOND) ; 


PRIMARY KEY, 


INTERVAL DAY(3) TO SECOND(2) 


DAY TO SECOND); 


45' DAY TO SECOND); 


SELECT * FROM interval ds sample 


The result set 


INTERVAL ID INTERVAL. VALLE 
110000 
2 0400.0 
30 0:20:0.0 
4000310 
5 0 0:0:31.450000000 
61 4:20:31 450000000 
7-1 4:20:31 450000000 
8 100 4:20:31 450000000 
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DAY(3) TO SECOND); 


Figure 17-12 How to work with the INTERVAL DAY TO SECOND type 
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How to use functions to work with intervals 


Figure 17-13 shows some of the common functions for working with 
intervals. For instance, you can use the first two functions to convert numbers to 
INTERVAL values. And you can use the last two functions to convert strings to 
INTERVAL values. 

The first four examples in the table show how you can use the 
NUMTOYMINTERVAL function to convert a number to an INTERVAL YEAR 
TO MONTH value. Within these statements, you can use the YEAR or MONTH 
keywords to specify the conversion unit. For example, the first two functions 
convert numbers to a year values, and the next two functions convert numbers to 
month values. Because the INTERVAL YEAR TO MONTH type doesn't have a 
component that can store the decimal portion of a month, the decimal part of the 
number in the fourth function is truncated. 

The next six examples show how to use the NUMTODSINTERVAL func- 
tion to convert a number to an INTERVAL DAY TO SECOND value. As you 
can see, this function works much like the NUMTOYMINTERVAL function. 

The last four examples in the table show how to use the 
TO. YMINTERVAL and TO DSINTERVAL functions. Here, the 
TO YMINTERVAL functions use two valid string literal formats for the same 
YEAR TO MONTH interval, but the first format specifies some leading zeros 
that aren't necessary. Then, the two TO DSINTERVAL functions show two 
valid string literal formats for the same DAY TO SECOND interval, but the first 
format specifies some leading zeros that aren't necessary. Either way, the results 
of the functions are the same. 

The final example in this figure shows how you can use these functions 
within a SELECT statement. Here, the only column that's returned by the 
SELECT statement uses the NUMTODSINTERVAL function to return an 
INTERVAL DAY TO SECOND value for the number of days that's calculated 
by subtracting the invoice date from the payment date in a table of invoices. 
This should give you some how idea of how the INTERVAL data types and 
functions can make it easier for you to work with intervals in your own applica- 
tions. 
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Common functions for working with intervals 


NUMTOYMINTERVAL(n, 'ym unit!) Converts a number to an INTERVAL YEAR TO MONTH 
value. The second argument must be YEAR or MONTH. 
NUMTODSINTERVAL(n, 'ds unit') Converts a number to an INTERVAL DAY TO SECOND 


value. The second argument must be DAY, HOUR, 
MINUTE, or SECOND. 


TO YMINTERVAL('ym literal!) Converts a string that contains a valid INTERVAL YEAR 


TO MONTH literal to the data type. 
TO DSINTERVAL('ds literal') Converts a string that contains a valid INTERVAL DAY TO 
SECOND literal to the data type. 


Examples that use functions to work with intervals 


NUMIOYMINTERVAL (2, 'YEAR') 
NUMTOYMINTERVAL (1.25, 'YEAR' ) 
NUMTOYMINTERVAL (2, 'MONTH' ) 
NUMTOYMINTERVAL (1.25, 'MONTH' ) 


NUMTODSINTERVAL (30, 'DAY') 30 0:0:0.0 
NUMTODSINTERVAL (30, 'HOUR') 1 6:0:0.0 
NUMTODSINTERVAL (30, 'MINUTE' ) 0 0:30:0.0 
NUMTODSINTERVAL (30, ' SECOND!) 0 0:0:30.0 
NUMTODSINTERVAL (90, ' SECOND! ) 0 0:1:30.0 
NUMTODSINTERVAL (30.123, 'SECOND') 0 0:0:30.123000000 


TO _YMINTERVAL ('01-03') 
TO_YMINTERVAL ('1-3') 


TO DSINTERVAL('1 06:00:00.00') l 6:0:0.0 
TO DSINTERVAL('l 6:0:0') 1 6:0:0.0 


A SELECT statement that retrieves an interval 


SELECT NUMTODSINTERVAL(payment date - invoice date, 'DAY') 
AS payment interval 

FROM invoices 

WHERE payment date IS NOT NULL 


Result set 


B PAYMENT |NTERV AL 
1 48:000 


2 61 0:0:0.0 
3 26 0:0:0.0 


Figure 17-13 How to use functions to work with intervals 
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Perspective 


In this chapter, you learned how you can use the TIMESTAMP and INTER- 
VAL data types to make it easier for you to work with time zones and intervals. 
Although this can be a little confusing as you read about all of the variations, you 
shouldn’t have much trouble applying what you’ve learned whenever you develop 
applications that require these features. 


Terms 


time zone 

offset 

Greenwich Mean Time (GMT) 
Coordinated Universal Time (UTC) 
database time zone 

session time zone 


Exercises 


1. Create a table named Timestamp_Values in the EX schema that contains four 
columns: timestamp_id as a NUMBER data type; timestamp_value as a 
TIMESTAMP(6) data type; timestamp_wltz_value as a TIMESTAMP WITH 
LOCAL TIME ZONE data type; and timestamp_wtz_value as a TIMESTAMP 
WITH TIME ZONE data type. Next, insert a row into this table with 1 for the 
id column, LOCALTIMESTAMP(3) for the second column, and 
CURRENT. TIMESTAMP(3) for the last two columns. Finally, write а 
SELECT statement that selects this data and review the data that's returned. 


2. First, change the date format for the current session so it shows the time in 24- 
hour format. Second, write a SELECT statement that retrieves the four columns 
of the one row in the Timestamp Values table that you created in exercise 1. 
Third, change the time zone for the session to MST. Fourth, insert a row just 
like the one you inserted in exercise 1 but with an id of 2. Fifth, run the 
SELECT statement again to review the differences in the two rows. 


3. Keep the date format for the current session as described in exercise 2. Then, 
write a SELECT statement that retrieves four columns from the 
Timestamp. Values table of exercises 1 and 2: (1) timestamp, id, (2) 
timestamp value, and (3) timestamp, value after it has been converted to 
Central Standard Time (CST) with cst, time as the column name. 


4. Keepthe date format for the current session as described in exercise 2. Then, 
write a SELECT statement that retrieves the invoice number and invoice date 
columns from the Invoices table in the AP schema, followed by a column 
named days old that uses an interval function to retrieve the number of days, 
hours, and seconds that have elapsed between the invoice date and the current 
date. Sort the rows by the days old value and only retrieve rows when the 
days old value is greater than 30. 
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How to work with large 
objects 


In chapter 8, you were introduced to the large object data types that can be used 
to store images, sound, video, and large amounts of text in an Oracle database. 
In this chapter, you'll review these data types, and you'll learn how to use 
them. 
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An introduction to large objects 


Oracle's large object (LOB) data types can store large amounts of character 
or binary data. These data types can be used to store data that's in just about any 
type of file including text, XML, Word, PDF, image, sound, and video files. 


The LOB types 


Figure 18-1 presents the four LOB types that were introduced with Oracle 
Database 8. The CLOB (Character Large Object) and NCLOB (National 
Character Large Object) types can store character data. These data types are 
commonly used to store large text and XML files. The primary difference 
between these types is that the CLOB type uses 1 byte per character to store 
characters in the ASCII character set while the NCLOB type uses 2 or 3 bytes 
per character to store characters in the Unicode character set. 

The BLOB (Binary Large Object) type can store data in binary format. It 
can be used to store binary files such as PDF files, and it can be used to store 
image, sound, and video files. 

The BFILE (Binary File) type stores a pointer to a binary file that's stored 
outside of the database. These binary files can be stored anywhere that's acces- 
sible through the host computer's file system. 

This figure also presents the old RAW, LONG, and LONG RAW data types 
for storing large objects that were used prior to Oracle Database 8. These data 
types are provided primarily for backward compatibility. Fortunately, it's easy 
to migrate to the new types if you want to do that as shown in figure 18-6. 


APIs for working with LOBs 


In most cases, LOBs are used by client-side applications. For example, a 
client-side application may want to get an image from a database and display it. 
Conversely, a client-side application may want to upload an image from a user's 
hard drive and store it in the database. 

To allow communication between a client-side application and the database, 
Oracle provides APIs for working with LOBs. Figure 18-1 lists some of the 
most commonly used APIs provided by Oracle. For example, it's common to 
use Java or a .NET language such as Visual Basic or С# to work with LOBs. In 
addition, Oracle provides an API for using PL/SQL to work with LOBs. Since 
PL/SQL doesn't provide any capabilities for viewing images or playing music, 
it's mainly used to perform server-side processing that can be called by a client- 
side application via a stored procedure or function. 

In this chapter, you'll learn how to use the Java API to store and retrieve a 
LOB from a database table. In addition, you'll be introduced to the PL/SQL API 
that you can use to perform server-side processing on LOBs. 


Chapter 18 How to work with large objects 


The new data types for large objects 
Description 


Character large object. Stores up to 8 terabytes of character data inside the database. 


National character large object. Stores up to 8 terabytes of national character data inside the 
database. 


Binary large object. Stores up to 8 terabytes of binary data inside the database. 


Binary file. Stores a pointer to a large binary file stored outside the database in the file 
system of the host computer. 


The old data types for large objects 


Description 


RAW (size) Stores up to 2000 bytes of binary data that is not intended to be converted by Oracle when 


moving data between different systems. 


LONG Stores up to 2 gigabytes of character data. 
LONG RAW Stores up to 2 gigabytes of row binary data that is not intended to be converted. 


Some of the APIs for working with large objects 


Java 

.NET Framework 
C++ 

COBOL 

PL/SQL 


Description 


The large object (LOB) data types can store large amounts of binary and character data. 


The CLOB, NCLOB, and BLOB types are sometimes referred to as internal LOB types, 
and the BFILE type is sometimes referred to as an external LOB type. 


The four new LOB types were introduced with Oracle Database 8. 


Oracle provides APIs for many programming languages that you can use to work with 
LOB types. 


Figure 18-1 The LOB types 
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How to use SQL to work with large 
objects 


If you want to work with LOBs, you need to store them in the database, and 
you need to retrieve them from the database. As you might expect, you can use 
the basic SQL statements to accomplish these tasks. 


How to work with CLOBs 


Figure 18-2 shows how to work with CLOBs. To start, the first example 
shows how to create a table named Product. Reviews that stores data of the 
CLOB type. Here, the first column in the table contains a NUMBER value that 
uniquely identifies each row. Then, the second column in the table contains a 
CLOB value. 

The second example shows a script that inserts three rows into the table. 
Here, the first INSERT statement uses the TO. CLOB function to convert a 
string literal to a CLOB value. This accomplishes two tasks: (1) it initializes a 
LOB locator that points to a CLOB value and (2) it inserts the characters in the 
string literal into the CLOB value. In contrast, the second INSERT statement 
uses the EMPTY, CLOB function to initialize a LOB locator that points to a 
CLOB value, but it doesn't fill the CLOB value with any data. Then, the third 
INSERT statement stores a NULL value, which doesn't initialize a LOB locator. 
Finally, the COMMIT statement commits the changes to the database. 

The third example shows a SELECT statement that retrieves data from the 
table. To start, this statement retrieves both of the columns of the table. Then, it 
creates a third column by using the LENGTH function to return the number of 
characters in the CLOB value that's stored in the database. 

The result set that's returned by the SELECT statement shows how SQL 
Developer displays a CLOB value. To start, it displays “(CLOB)” to indicate 
that the column contains a LOB locator that has been initialized. Then, it 
displays any characters that have been stored in the CLOB. However, if the 
LOB locator hasn't been initialized, the result set displays a NULL value. 

Of course, if you're using another tool such as SQL*Plus, the display may 
be different. For example, by default, SOL*Plus only displays the first 80 
characters of a CLOB value. 


How to work with NCLOBs 


Once you understand how to work with CLOBs, you should be able to 
apply most of those skills to NCLOBs. For example, to convert figure 18-2 so it 
works with NCLOBs, you just specify the NCLOB type in the table definition 
and use the TO NCLOB function in the first INSERT statement. The rest of the 
code works the same. 
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А statement that creates a table that can store CLOBs 


CREATE TABLE product reviews 

( 
product id NUMBER PRIMARY KEY, 
product review  CLOB 

); 


A script that inserts three rows into the table 
INSERT INTO product reviews VALUES 
(1, TO CLOB('Imagine this is a long string of characters.')); 


INSERT INTO product reviews VALUES 
(2, EMPTY СІОВ()); 


INSERT INTO product reviews VALUES 
(3, NULL); 


COMMIT; 


A statement that displays the values in the table 


SELECT product id, product review, 
LENGTH(product review) AS clob length 
FROM product reviews; 


The result set 


PRODUCT. 10 |PRODUCT_REVIEVY CHAR, COUNT 
1 (CLOB) Imagine this Is a lang string of characters. 44 


2 (CLOB) o 
3 (nul) (null) 


Description 


e When you create a table, you can use the CLOB or NCLOB data types just as you would 


use any other data type. 


e You can use the TO CLOB and TO NCLOB functions to convert a string to the CLOB 


or NCLOB types. 


e ‘You can use ће EMPTY CLOB function to return a LOB locator for an empty CLOB or 


NCLOB. 


e You can use the LENGTH function to return the number of characters that are stored in a 


CLOB or NCLOB. 


Figure 18-2 How to work with CLOBs 
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How to work with BLOBs 


Figure 18-3 shows how to work with BLOBs. If you understand how to 
work with CLOBs as described in the previous figure, you shouldn't have much 
trouble working with BLOBs since many of the same skills apply. The main 
difference is that you use the TO BLOB and EMPTY_BLOB functions instead 
of the TO CLOB and EMPTY_CLOB functions. In addition, when applied to a 
BLOB, the LENGTH method returns the number of bytes instead of the number 
of characters. 

Since binary data consists of ones and zeros, it's hard to code a meaningful 
string literal for a BLOB. In this figure, I coded 32 hexadecimal digits for a total 
of 16 bytes. Since a hexadecimal digit represents four bits (binary digits), two 
hexadecimal digits represent eight bits, which is one byte. As a result, the 
number of bytes for a hexadecimal string literal will always be the number of 
hexadecimal digits divided by two. Later in this chapter, you'll learn how to 
store binary data for a JPG image in the database by reading the binary data for 
the JPG image from a file and storing it in the database. 

Since it isn't easy to present binary data in a form that's meaningful to 
humans, SQL Developer has limited capabilities for displaying a BLOB. 
Although it can display “(BLOB)” to indicate that the column contains a LOB 
locator that has been initialized, it can't display the binary data. 

For the sake of comparison, if you try to use SQL*Plus to display a BLOB, 
it will display a message that says: 

8Р2-0678: Column or attribute type can not be displayed by SQL*Plus 
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А statement that creates a table that can store BLOBs 


CREATE TABLE product images 

( 
product id NUMBER PRIMARY KEY, 
product image  BLOB 

); 


А script that inserts three rows into the table 


INSERT INTO product images VALUES 
(1, TO_BLOB ('0123456789ABCDEF0123456789ABCDEF') ) ; 


INSERT INTO product_images VALUES 
(2, EMPTY _BLOB()); 


INSERT INTO product images VALUES 
(3, NULL); 


COMMIT; 


A statement that displays the values in the table 


SELECT product_id, product_image, 
LENGTH (product_image) AS byte_count 
FROM product images; 


The result set 


ü PRODUCT 10 |PRODUCT Is GE F BYTE COLM | 


T 
1 1 (BLOB) 16 ^ 
2 2 (BLOB) 0 
3 3 (пи (null) 


Description 


When you create a table, you can specify the BLOB type just as you would specify any 
other data type. 


You can use the TO_BLOB function to convert a string literal that contains a series of 
hexadecimal values to a BLOB value. 


You can use the EMPTY_BLOB function to return a LOB locator for an empty BLOB. 


You can use the LENGTH function to return the number of bytes that are stored in a 
BLOB. 


Figure 18-3 How to work with BLOBs 


567 


568 Section 5 Advanced data types 


How to work with BFILEs 


Figure 18-4 shows how to work with the BFILEs. Like a BLOB, a BFILE stores 
binary data. Unlike a BLOB, a BFILE stores a reference to a file that's stored outside 
the database. That's why the BFILE type is sometimes referred to as an external LOB 
type while the BLOB and CLOB types are sometimes referred to as the internal LOB 
types. 

To work with a BFILE, you start by defining a table that includes a BFILE column. 
In this figure, the first example creates a table named Product, Images 2 that stores 
data of the BFILE type. Here, the second column in the table contains a BFILE value. 
This works like the BLOB example shown in the previous figure except that the binary 
file is stored outside of the database. 

Before you can work with a BFILE value, you need to use the CREATE DIREC- 
TORY statement to store a reference to a directory in the database. This directory can 
be any directory that's available to the file system of the host computer. In this figure, 
the second example creates a directory named images dir that refers to a directory 
named ch18files that's stored on the same drive as the database server. However, this 
directory could be stored on any network drive that's available to the computer that's 
running the database server. 

Note that this example uses front slashes to separate the directory entries. That's 
because front slashes work for both Windows and Unix while backslashes only work 
on Windows. 

Once you've created a directory for the files that store the binary data, you can use 
the BFILENAME function to return a LOB locator for the specified directory and 
filename. In this figure, the third example begins by using the BFILENAME function 
within an INSERT statement to insert a LOB locator for a binary file named 
"8601. cover.jpg" that's stored in the directory that was created in the previous ex- 
ample. Then, the second INSERT statement uses the same technique to insert a LOB 
locator for a binary file named "jr01, cover.jpg". Next, the third INSERT statement 
inserts a NULL value. Finally, the COMMIT statement commits these changes to the 
database. 

The fourth example uses a SELECT statement to view the values that are stored in 
the Product, Images 2 table. Here, SQL Developer displays “(BFILE)” for BFILE 
column in the first two rows to indicate that a LOB locator has been stored in these 
rows. However, it displays "(null)" for the BFILE column of the third row to indicate 
that a NULL value has been stored in this row. 

If necessary, you can use the DROP DIRECTORY statement to drop a reference to 
a directory from the database. If, for example, the directory that contains your binary 
files is moved, you can drop the reference to this directory from the database. Then, 
you can create a new reference with the same name as the old reference that refers to 
the new directory. 

If, for example, the ch18files directory is moved to a network drive, you can drop 
the directory named product, dir from the database. Then, you can create a new 
directory named product, dir that refers to the new location for the ch18files directory. 
That way, you won't have to change any of your existing code that uses the directory 
named product dir. 
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A statement that creates a table that can store BFILEs 


CREATE TABLE product images 2 

( 
product id NUMBER PRIMARY KEY, 
product image  BFILE 

); 


А statement that identifies а directory that stores binary files 
CREATE DIRECTORY product dir AS 'C:/murach/oracle sql/java/ch18f11es'; 


А script that inserts three rows into the table 


INSERT INTO product images 2 VALUES 
(1, BFILENAME('product dir', !'8601 cover.jpg')); 


INSERT INTO product images 2 VALUES 
(2, BFILENAME('product dir', 'jr01 cover.jps')):; 


INSERT INTO product images 2 VALUES 
(3, NULL); 


COMMIT; 


A statement that displays the values in the table 
SELECT product id, product image 


FROM product images 2; 
The result set 


a PRODUCT 0 PRODUCT IMAGE 
1 (BFILE) 


2 (BFILE) 
3 (null) 


A statement that drops a directory 
DROP DIRECTORY product dir; 


Description 


e You can use the CREATE DIRECTORY statement to store a reference to a directory in 


the database. 


e You can use the DROP DIRECTORY statement to drop a reference to a directory from 


the database. 


e You can use BFILENAME function to return a LOB locator for the specified directory 


and filename. 


Figure 18-4 How to work with BFILEs 
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How to specify LOB storage options 


So far, the examples presented in this chapter have used the default options 
for storing LOB values. However, when you create a table that stores LOBs, you 
can often improve the performance of LOB operations by specifying the storage 
options shown in figure 18-5. 

To code the storage options for a LOB, you code one LOB clause for each 
LOB column in a table. In this figure, the CREATE TABLE statement contains 
a single LOB clause for the BLOB column named product, image. However, if a 
table contains multiple LOB columns, you can specify one LOB clause for each 
column. Or, if you want to use the same settings for multiple LOB columns, you 
can code the LOB keyword, followed by a set of parentheses. Then, within the 
parentheses, you can code multiple column names, separated by commas. 

You may also be able to improve performance by using the TABLESPACE 
option to specify a separate tablespace for storing LOB values instead of the 
tablespace that's used for storing the rest of the data in the table. In this figure, 
for example, the table is stored in the tablespace named users. However, the 
LOB values for the table are stored in the tablespace named users lobs. Before 
you attempt to create a separate tablespace to store LOB values, though, you 
may want to consult your DBA to make sure that a separate tablespace will 
result in improved performance. 

Since LOBs are usually large, you can often improve performance by 
reading and writing large amounts of data at a time. To accomplish this, you can 
use the CHUNK option to set the chunk size, which is how many bytes can be 
read at a time. By default, the chunk size is set to the same size as the block 
size, Which is set when the tablespace is created. However, you often want to set 
the chunk size so it's a larger multiple of the block size. That way, Oracle can 
read multiple blocks at a time. Since block size is often set to 8КВ (8192 bytes), 
you can usually set the chunk size to a larger multiple of 8KB such as 16KB 
(16384 bytes) or 32KB (32768 bytes). 

By default, the ENABLE STORAGE IN ROW option stores the LOB value 
in the row if it is less than 4KB (4096 bytes) and stores the LOB value out of 
the row if the LOB value is greater than 4KB. In general, this option works well 
if all of your LOB values are either less than or greater than 4KB. However, if 
your LOB values are of a wide range of sizes, you may want to use the DIS- 
ABLE option to store all of the LOB values outside the row. This improves the 
performance for SELECT and UPDATE statements on non-LOB columns. 

By default, the NOCACHE option prevents LOB blocks from being cached. 
However, if the same LOB data is accessed frequently, you may be able to 
improve performance by using the CACHE option to cache reads and writes or 
the CACHE READS option to only cache reads. 

When you use the NOCACHE or CACHE READS options, you can specify 
the LOGGING and NOLOGGING options. For most operations, you want to 
use the LOGGING option. However, if you're loading a large amount of data 
into the database, you may be able to improve performance by using the 
NOLOGGING option. To do that, you can use the ALTER TABLE statement to 
modify the table so the LOB column uses the NOCACHE and NOLOGGING 
options. 


Chapter 18 How to work with large objects 


The syntax for the LOB clause of a CREATE TABLE statement 


LOB (lob column namel[, lob column name2]) 

STORE AS lob sBegment name 

( 
[TABLESPACE users] 
[CHUNK chunk size] 
[{ENABLE | DISABLE} STORAGE IN ROW] 
[(NOCACHE|CACHE [READS]} [{LOGGING|NOLOGGING}] ] 
[PCTVERSION percentage_threshold] 

) 


A CREATE TABLE statement that specifies LOB storage details 


CREATE TABLE product images 

( 
product id NUMBER PRIMARY KEY, 
product image BLOB 


TABLESPACE users 
LOB (preduct image) 
STORE AS product image lob seg 
( 
TABLESPACE users lobs 
CHUNK 32768 
DISABLE STORAGE IN ROW 
CACHE READS LOGGING 
PCTVERSION 20 
) 


Description 


You can code one STORE AS clause for each LOB column in a table, and you must 
specify at least one of the storage options for each STORE AS clause. You can also code 
a STORE AS clause that applies to more than one column. 

The TABLESPACE option specifies the tablespace for storing the LOB values for a 
column. 

The CHUNK option controls how many bytes can be read at a time. By default, the 
CHUNK option is set to the same size as a block. The chunk size must be set to a mul- 
tiple of the block size, which is often set to 8KB (8192 bytes). 

The ENABLE STORAGE IN ROW option stores the LOB value in the row if it is less 
than 4KB (4096 bytes) and stores a pointer to a file if the LOB value is greater than 
4KB. The DISABLE STORAGE IN ROW option prevents LOB values from being 
stored in the row. 

The CACHE and NOCACHE options control how LOB blocks are cached. By default, 
the NOCACHE option is used. When you specify the NOCACHE and CACHE READS 
options, you can specify the LOGGING and NOLOGGING options. 

The PCTVERSION option is used when a LOB value is changed. It controls the percent- 
age of LOB blocks that can contain old LOB data for undo operations before the old 
LOB blocks can be reused by Oracle. By default, this option is set to 10 percent. 


Figure 18-5 Ном to specify LOB storage details 
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The PCTVERSION option is used when a LOB value is changed. It con- 
trols the percentage of LOB blocks that contain old LOB data that can be used 
for undo operations. By default, this option is set to 10 percent. However, if the 
updates of your LOB values are frequent and large, you may be able to improve 
performance by increasing this value. Conversely, if the updates to your LOB 
values are infrequent and small, you may be able to decrease the value for this 
option. For example, if access to your LOBs is read-only, you can set this value 
to 0 since there will never be any old LOB data. 


How to migrate to the new LOB types 


The new LOB types that I've just described provide a richer set of features 
for working with large objects than the old LOB types. Аз a result, you typically 
want to use the new LOB types whenever possible. Fortunately, if you're 
working with old tables that use the old LOB types, it's easy to migrate those 
old LOB types to the new LOB types. 

To do that, you can use the ALTER TABLE statement as shown in figure 
18-6. Here, the first example creates a table that includes a column that uses the 
old LONG RAW type to store binary data. Then, the second example stores two 
rows of data in this table. Finally, the third example uses the ALTER TABLE 
statement to convert the LONG RAW type to the new BLOB type. 

Similarly, if a table contains character data of the old LONG type, you can 
convert it to the CLOB type by substituting the LONG data type for the LONG 
RAW data type. In either case, though, you'll want to thoroughly test the 
conversion to make sure it works correctly before you implement it on a produc- 
tion database. 
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А statement that creates a table that uses the old LONG RAW data type 


CREATE TABLE product images 3 

( 
product id NUMBER PRIMARY KEY, 
product image LONG RAW 

); 


A script that inserts two rows 


INSERT INTO product images 3 VALUES 
(1, '1010101010101010101010101010101010'); 


INSERT INTO product images 3 VALUES 
(2, '1010101010101010101010101010101010'); 


COMMIT; 


А statement that migrates data from the LONG RAW type to the BLOB 
type 

ALTER TABLE product images 3 MODIFY (product image BLOB); 
Description 


e ‘You can use an ALTER TABLE statement to convert the old LONG RAW type to the 
BLOB type. 


e ‘You can use an ALTER TABLE statement to convert the old LONG type to the CLOB 
type. 


Figure 18-6 How to migrate to the new LOB types 
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How to use Java to work with large 
objects 


Since it's common to use Java to work with Oracle LOBs, this topic pre- 
sents a simple application that uses the Java API to work with large objects. 
This application consists of three Java classes. By studying this application, you 
can learn how to read a binary file for an image and write it to a BLOB column 
in a database table. You can also learn how to read a BLOB from a database 
table and write it to a file. 

If you have some Java programming experience, you shouldn't have much 
trouble understanding this code. If you don't have Java experience, that's okay 
too. In that case, you can focus on how this code uses the Java API to execute 
the SQL statements against an Oracle database. Then, if you want to learn more 
about using Java to work with a database, we recommend Murach's Java SE 6 
and Murach's Java Servlets and JSP. 

Before you attempt to execute the code in this topic, you need to add a JAR 
file that contains the Oracle JDBC driver to your classpath. That way, Java will 
be able to find the files for the driver. The easiest way to do that is to copy the 
JAR file that contains the drivers into the JDK’s jre/lib/ext directory. This is 
explained in more detail in figure 1-19 of chapter 1. 

In this topic, the code works with a BLOB. However, a similar technique 
can be used for working with a CLOB, NCLOB, or BFILE. Whatever LOB type 
you use, the Java API lets you execute the SQL statements described earlier. 


The main method for the sample application 


The BLOBTestApp class presented in figure 18-7 contains the main method 
for the application presented in this topic. This method begins by declaring 
three variables that are used by the rest of the statements in this method. Here, 
the first statement declares a string named productsDir that points to the 
ch18files directory. The second statement declares a string variable named 
filePath that will be used to store the complete path to the file. And the third 
statement declares an integer variable named byteCount that will be used to 
store the count of the bytes that are written or read by each operation. 

After declaring these three variables, the main method uses the writeImage 
method of the ProductDB class to write three images to the database. Here, each 
group of statements begins with a statement that sets the value of the filePath 
variable by concatenating the productsDir variable with the name of the file to 
write to the database. Then, the second statement passes a product ID value and 
the filePath value to the writeImage method of the ProductDB class. Finally, the 
third statement prints the byteCount variable that’s returned by this method to 
the console. Note that all three of these statements work because they point to 
JPG files that exist within the ch18files directory. 

After writing three images to the database, the main method continues by 
using the readImage method of the ProductDB class to read one image from the 
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A Java class that reads and writes Oracle LOBs 
public class BLOBTestApp 


public static void main(String args[]) 


String productsDir = 
"C:/murach/oracle_sql/java/chl8files/"; 

String filePath = ""; 

int byteCount = 0; 


// Read 3 images from file and write to database 

filePath = productsDir + "8601 cover.jpg"; 

byteCount = ProductDB.writeImage(1, filePath) ; 
System.out.println(byteCount + " bytes written to the database."); 


filePath = productsDir + "pf01 cover.jpg"; 
byteCount = ProductDB.writeImage(2, filePath) ; 
System.out.println(byteCount + " bytes written to the database."); 


filePath = productsDir + "jr01 cover.jpg"; 
byteCount = ProductDB.writeImage(3, filePath) ; 
System.out.println(byteCount + " bytes written to the database."); 


// Read 1 image from database and write to file 

filePath = productsDir + "8601 temp.jpg"; 

byteCount = ProductDB.readImage(1, filePath) ; 
System.out.println(byteCount + " bytes read from the database."); 


The result 
| £ «ID x 
3573 bytes written to the database. Р 
3579 bytes written to the database. 
18157 bytes written to the database. 
3573 bytes read from the database. 
Press any key to continue . . 
Description 


e In this example, the code works with a BLOB. However, a similar technique could be 
used for working with a CLOB, NCLOB, or BFILE. 


Figure 18-7 The BlobTestApp class 
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database. Specifically, this method reads the product image for the product with a 
product ID of 1, and it writes this product to a file named “8601 temp.jpg". Note 
that this statement works whether or not this file exists. If the file doesn't exist, it 
is created. Otherwise, it is overwritten. To verify this, you can use a graphics 
program such as Paint to open this file and view it. 

After the class in this figure, you can see the data that is printed to the 
console by the main method. The first three lines show that three images with 
different byte counts were written to the database. The fourth line shows that one 
image was read from the database. The byte counts, of course, are returned by the 
wtiteImage and readImage methods that are stored in the ProductDB class, which 
is presented next. 


How to write an image to a table 


The ProductDB class in figure 18-7 begins by importing all Java JDBC and 
IO classes necessary for working with LOBs. In addition, it imports two Oracle 
JDBC classes that yield better performance than the Java JDBC classes. These 
classes are stored in the same JAR file that contains the Oracle JDBC driver. As a 
result, you need to add this JAR file to your classpath as described in figure 1-19 
of chapter 1. 

This code shows that there are two sets of JDBC classes that you can use 
when using Java to work with an Oracle database. In addition, it shows that you 
can mix and match these classes as you see fit. 

The ProductDB class contains a static writelmage method that you can use to 
read an image from a file and write it to a column in a table. This method accepts 
two parameters. The first parameter specifies the ID that uniquely identifies the 
product. The second parameter specifies the complete path to the file. 

Within the body of the writelmage method, the first three statements declare 
the Connection, PreparedStatement, and OracleResultSet objects that are used by 
the rest of the method. Here, the static getConnection method of the DBUtil class 
returns a Connection object. To see how this method works, you can view the 
code for the DBUtil class that’s presented in figure 18-9. 

After the first three statements, the code in the try block sets up an input 
stream for the file path specified by the second parameter. Then, it uses the Java 
API to execute an INSERT statement that stores a LOB locator for a BLOB value 
in the database. 

After inserting a new row, this code uses the Java API to execute a SELECT 
statement that retrieves a LOB locator for the newly inserted BLOB and stores it 
in the variable named productImageBLOB. Note that this SELECT statement 
must include a FOR UPDATE clause. This clause indicates that the BLOB is 
being retrieved for an update, and it causes the BLOB value to be locked until 
you commit or roll back the update. As a result, it’s critical that your code either 
commits or rolls back the update. 

After getting a reference to the BLOB, this code sets up the output stream to 
the database. To do that, it calls the setBinaryStream method from the variable 
named productImageBLOB and it passes an argument of 0 to begin writing at the 
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The ProductDB class Part 1 


// import all necessary Java JDBC and IO classes 
import java.sql.*; 
import java.io.*; 


// import two Oracle JDBC classes for better performance! 
import oracle.sql.BLOB; 
import oracle.jdbc.OracleResultSet; 


public class ProductDB 
public static int writelmage(int product id, String file path) 


Connection connection s DBUtil.getConnection(); 
PreparedStatement ps » null; 
OracleResultSet rs = null; 
try 
{ 
// set up the input stream from file 
File inputFile - new File(file path); 
FlleInputStream fileInputStream = new FileInputStream(inputFile) ; 


// initialize the BLOB in the database 

String sql = 
"INSERT INTO product images (product_id, product_image) " + 
n VALUES(?, EMPTY BLOB())"; 

ps = connection.prepareStatement (sql); 

ps.setInt(1, product id); 

ps . executeUpdate (); 


// get a reference to the BLOB 
sql = 
"SELECT product image " + 
"FROM product images " + 
"WHERE product id = ? " + 
"FOR UPDATE"; 
ps = connection.prepareStatement (sql); 
ps.setInt(1, product id); 
rs = (OracleResultSet) ps.executeQuery(); 
rs.next(); 
BLOB productImageBLOB = rs.getBLOB("product image") ; 


// set up the output stream to the database 
OutputStream outputStream = productImageBLOB.setBinaryStream(0) ; 


// set up the buffer 


int chunkSize = productImageBLOB.getChunkSize(); 
byte[] byteBuffer = new byte[chunkSize]; 


Figure 18-8 The ProductDB class (part 1 of 3) 


577 


578 


Section 5 Advanced data types 


first byte of the column. After setting up the output stream, this code sets up the 
buffer that's used to temporarily store the bytes as they're transferred from the 
input stream to the output stream. Note that the getChunkSize method is called 
from the BLOB object to return the chunk size to use when reading and writing 
the BLOB value. 

After setting up the buffer, the try block uses a while loop to read from the 
input stream (the specified file) and write to the output stream (the specified 
column in the database). When this loop finishes, the code closes the input and 
output streams, commits the change, and returns the total number of bytes that 
were written to the database. If this loop completes successfully, the number of 
bytes that were written will be the same as the number of bytes that were read. 

After the try block, the catch block catches any exceptions that might have 
occurred and handles them. To do that, this catch block prints the exception to 
the console, rolls back any changes, and returns a value of 0. 

After the catch block, the finally block frees the resources that are used by 
the writelmage method. To do that, this block uses three static methods that are 
available from the DBUtil class shown in figure 18-9 to close the ResultSet, 
PreparedStatement, and Connection objects. 
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The ProductDB class Part 2 


// read input and write output 
int byteCount = 0; 
int bytesRead = 0; 
while ((bytesRead = fileInputStream.read(byteBuffer)) l= -1) 
{ 
outputStream.write(byteBuffer, 0, bytesRead) ; 
byteCount += bytesRead; 


// close the input and output streams 
fileInputStream.close(); 
outputStream.close(); 


// commit the changel 
connection.commit(); 


return byteCount; 


catch (Exception e) 


{ 
e.printStackTrace(); 
DBUtil.rollback (connection); 
return 0; 

finally 


DBUtil.closeResultSet (rs); 
DBUtil.closePreparedStatement (ps); 
DBUtil.closeConnection (connection); 


Figure 18-8 Тһе ProductDB class (part 2 of З) 
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How to read an image from a table 


Besides the static writeImage method, the ProductDB class also contains a 
static readimage method that you can use to read an image from a column in the 
database and write it to a file. For the most part, this works like the writelmage 
method in reverse. However, since the readImage method doesn't update the 
database, you don't need to obtain a lock on the LOB value. Аз a result, you 
don't need to add the FOR UPDATE clause to the SELECT statement. In 
addition, you don't need to commit or roll back any changes to the database. 
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The ProductDB class Part 3 


public static int readImage(int product id, String filename) 
{ 
Connection connection z DBUtil.getConnection(); 
PreparedStatement ps = null; 
OracleResultSet rs = null; 
try 
{ 
// set up output stream to file 
File outputFile = new File(filename) ; 
FileOutputStream outputStream = new FileOutputStream(outputFile); 


// set up input steam from database 
String sql = 
"SELECT product_image " + 
"FROM product_images " + 
"WHERE product id = ?"; 
ps = connection.prepareStatement (sql); 
ps.setInt(l1, product id); 
гв = (OracleResultSet) ps.executeQuery(); 
rs.next(); 
BLOB productImageBLOB = rs.getBLOB("product image"); 
InputStream inputStream = productImageBLOB.getBinaryStream(); 


// set up the buffer 
int chunkSize = productImageBLOB.getChunkSize(); 
byte[] binaryBuffer = new byte [chunkSize]; 


// read input and write output 

int byteCount = 0; 

int bytesRead = 0; 

while ((bytesRead = inputStream.read(binaryBuffer)) l= -1) 


outputStream.write(binaryBuffer, 0, bytesRead) ; 
byteCount += bytesRead; 


// close the input and output streams 
outputStream.close(); 
inputStream.close(); 

return byteCount; 


catch (Exception e) 


e.printStackTrace(); 
return 0; 


finally 
DBUtil.closeResultSet (гв) ; 


DBUtil.closePreparedStatement (ps); 
DBUti1l.closeConnection (connection); 


Figure 18-8 The ProductDB class (part 3 of 3) 
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А utility class for working with databases 


The DBUtil class presented in figure 18-9 contains static methods that are 
used by the ProductDB class. To start, the getConnection method returns a 
Connection object for the EX user. To do that, the first block of code uses the 
forName method of the Class class to load the Oracle JDBC driver. This block 
of code is needed if you're using Oracle 10g because its database driver uses 
JDBC 3.0 (which is part of JDK 1.5). If you're using Oracle 11g, though, you 
will usually want to omit this block of code because the 11g driver supports 
JDBC 4.0 (which is part of JDK 1.6), and JDBC 4.0 can automatically find the 
driver. 

After the driver has been loaded, the second block creates and returns a 
Connection object. To do that, the first statement specifies a database URL that 
uses the thin driver to connect to the Express Edition (XE) of Oracle that's 
running on port 1521 on the same computer as the Java application. Then, the 
second and third statements specify the username and password for the EX user. 
The fourth statement uses the getConnection method of the DriverManager 
class to return a Connection object. Апа the fifth statement returns the Connec- 
tion object to the calling method. 

After the getConnection method, the DBUtil class provides a rollback 
method. This method accepts a Connection object as a parameter. Then, the 
body of the method checks to make sure the Connection object is not null. In 
that case, it calls the rollback method of the Connection object to rollback any 
changes. In addition, this method handles the exception that may be thrown by 
the rollback method by printing the stack trace to the console. This exception 
handling makes it easier for other classes like the ProductDB class to rollback 
changes. 
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The DBUtil class Part 1 


import java.sql.*; 


public class DBUtil 


public static Connection getConnection() 


{ 


} 


// Load the database driver 
// NOTE: This block is necessary for Oracle 10g (JDBC 3.0), 
// but not for Oracle 11g (JDBC 4.0) 


try 
Class.forName("oracle.jdbc.OracleDriver"); 
catch(ClassNotFoundException e) 


e.printStackTrace(); 
return null; 


} 


// Return а connection to the database 
try 
{ 
String dbUrl = "jdbc:oracle:thin:Glocalhost:1521:XE"; 
String username = "ex"; 
String password = "ex"; 
Connection connection s DriverManager.getConnection( 
dbUrl, username, password); 
return connection; 


catch(SQLException e) 


e.printStackTrace(); 
return null; 


public static void rollback(Connection c) 


try 
{ 
if (¢ J= null) 
c.rollback(); 


catch(SQLException e) 


e.printStackTrace(); 


Figure 18-9 The DBUtil class (part 1 of 2) 
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This class also contains the closeConnection, closePreparedStatement, and 
closeResultSet methods. Like the rollback method, the exception handling that's 
implemented by these methods makes it easier for other classes such as the 
ProductDB class to close JDBC objects. If, for example, you look at the finally 
clause in both the readImage and writelmage methods of the ProductDB class, 
you can see that the methods of the DBUtil class are used to close the Connec- 
tion, PreparedStatement, and ResultSet objects. In addition, the methods of the 
DBUtil class let you store the exception handling code for closing JDBC objects 
in a single location. 
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The DBUtil class Part 2 


public static void closeConnection (Connection c) 


{ 
try 
{ 
1f (c 1= null) 
с.с1ове(); 
catch(SQLException e) 


{ 


e.printStackTrace(); 
) 
public static void closePreparedStatement(PreparedStatement ps) 
try 


1f (ps l= null) 
ps.close(); 


catch(SQLException e) 


e.printStackTrace(); 


) 
public static void closeResultSet(ResultSet rs) 
{ 
try 
if (rs l= null) 
rs.close(); 
catch(SQLException e) 
e.printStackTrace(); 
) 


Figure 18-9 The DBUtil class (part 2 of 2) 
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How to use PL/SQL to work with large 
objects 


Since PL/SQL runs on the server, it only provides limited capabilities for 
viewing or interacting with LOB types. However, the DBMS LOB package 
provided by Oracle makes it possible to use PL/SQL to perform a wide range of 
server-side processing on the LOB types. 


The methods of the DBMS LOB package 


Figure 18-10 shows the most commonly used methods of the DBMS LOB 
package. Technically, the methods of the DBMS LOB package are actually 
stored procedures or functions. However, to make it easier to refer to these 
procedures and functions, they are often referred to as methods. 

Although this figure doesn't present the operational details for using these 
methods, it does give you a general idea of what types of operations are avail- 
able from this package. For a complete list of methods that are available from 
this package and for the operational details on how to use them, you can search 
the Internet for the Oracle Database PL/SQL Packages and Types Reference. 

In this figure, you can use the first group of methods to work with the 
CLOB, NCLOB, BLOB, and BFILE types. Of course, not all of these methods 
are available for all types, but most of these methods work where you would 
expect them to work. For example, you can use the OPEN and CLOSE methods 
to open and close all types of LOBs, and you can use the ISOPEN method to 
check if a LOB is already open before you attempt to open it. 

Once you have a LOB open, you can use the rest of the methods in this 
group to work with the LOBs. For example, you can use the APPEND method 
to append one LOB to another LOB of the same type. Or, you can use the 
READ method to read from one LOB, and you can use the WRITE method to 
write to another LOB of the same type. Or, you can use the 
CONVERTTOBLOB function to convert a CLOB value to a BLOB value. Or, 
you can use the last three methods in this group to create and work with a 
temporary LOB that's used within a block of PL/SQL code. 

You can use the second group of methods to work with BFILE types. For 
example, you can use the FILEEXISTS method to check if the binary file for a 
BFILE exists. Or, you can use the FILEISOPEN method to check if the binary 
file for a BFILE is open. Or, you can use the FILECLOSEALL method to close 
all binary files that are open. Or, you can use the last two methods to load data 
from a BFILE to a BLOB or CLOB value. 
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General methods for working with LOBs 
OPEN Opens a LOB. 
CLOSE Closes a LOB. 
ISOPEN Checks if a LOB is open. 


APPEND Appends one LOB to another. 
COPY Copies all or part of one LOB to another. 
ERASE Erases part of a LOB. 


COMPARE Compares all or part of a LOB. 

INSTR Checks if a string pattern exists in a LOB. 
SUBSTR Reads a string from a LOB. 

TRIM Trims the LOB to the specified size. 


READ Reads data into a buffer. 

Writes the buffer to a LOB. 
WRITEAPPEND Appends the buffer to a LOB. 
GETCHUNKSIZE Gets the chunk size of the LOB. 
GETLENGTH Gets the length of the LOB. 


CONVERTTOBLOB Converts a CLOB to a BLOB. 
CONVERTTOCLOB Converts a BLOB to a CLOB. 


CREATETEMPORARY Creates a temporary LOB. 
FREETEMPORARY Frees the resources used by a temporary LOB. 
ISTEMPORARY Checks if a LOB is temporary. 


Methods for working with BFILEs 
Method name Description 
FILEEXISTS Checks if a BFILE exists. 
FILEISOPEN Checks if a BFILE is open. 
FILECLOSEALL Closes all open BFILEs. 


FILEGETNAME Gets the directory and filename for a BFILE. 


LOADBLOBFROMFILE Loads data from a BFILE to a BLOB. 
LOADCLOBFROMFILE Loads data from a BFILE to a CLOB or NCLOB. 


Figure 18-10 The methods of the DBMS LOB package 
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An example that uses the DBMS LOB package 


Figure 18-11 begins by showing a stored procedure that uses the 
DBMS LOB package to compare two BLOB values. Then, it shows a script 
that calls this stored procedure and prints a message to the output window. This 
example is intended only to give you a general idea of how you can write PL/ 
SQL code that uses the DBMS, LOB package to work with LOBs. 

To start, the stored procedure named compare blobs defines three param- 
eters. Here, the first two parameters are IN OUT parameters for the two BLOB 
values to compare. When specifying a parameter for a LOB type, the parameter 
must be an IN OUT parameter since Oracle needs to both read and write data 
from these parameters. 

If you don't plan on modifying the LOB parameter, you may be able to 
improve performance by including the optional NOCOPY hint for these types 
of parameters. This hint tells the PL/SQL compiler to use a reference to the 
variable instead of incurring the overhead of making a copy of the variable. 
Finally, the third parameter is an OUT parameter of the NUMBER type that's 
used to indicate whether the two BLOB values are the same. 

After the parameters have been declared, the procedure declares and initial- 
izes three variables. Here, the first two variables specify a value of 1 for the 
offsets for the two BLOB values. This causes the comparison of the BLOB 
values to start at the beginning of each of the BLOB values. Note that Oracle 
uses an offset of 1 to indicate the beginning of a LOB while some other APIs 
such as Java use an offset of O. 

After the variables have been declared, the body of the stored procedure 
uses the COMPARE method of the DBMS ТОВ package to compare both of 
the BLOB values that were passed in as parameters. This method returns a value 
of 0 if the two LOB values are the same. Otherwise, it returns a value of -1. 
Finally, the body of the stored procedure handles any exceptions by printing an 
error message to the output window. 

The script that calls the compare, blobs procedure begins by declaring two 
variables to store the two BLOB values and a third variable to store the value 
that's returned by the procedure. Within the body of the script, the two SELECT 
statements read the BLOB values into the two BLOB variables for the products 
with IDs of 1 and 2. In this case, the BLOB values are images that are stored in 
the Product, Images table. Then, the script calls the compare, blobs procedure, 
which stores the returned value in the variable named compare, result. Finally, 
an IF statement checks whether this variable is equal to 0. If so, it prints a 
message to the output window that indicates that the two images are equal. 
Otherwise, it prints a message to the output window that indicates that the two 
images are not equal. 
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А stored procedure that compares BLOBs 
CONNECT ex/ex; 


CREATE OR REPLACE PROCEDURE compare blobs 
( 


blobl IN OUT NOCOPY  BLOB, 
blob2 IN OUT NOCOPY BLOB, 
compare result OUT NUMBER 
) 
AS 


blobl_offset NUMBER := 1; 

blob2 offset NUMBER :- 1; 

buffer size NUMBER := 32768; 
BEGIN 

compare result := DBMS LOB.COMPARE(blobl, blob2, buffer size, 

blobl offset, blob2 offset); 

EXCEPTION 

WHEN OTHERS THEN 

DBMS OUTPUT.PUT LINE (SQLERRM) ; 

END; 
/ 


А script that uses the stored procedure 
SET SERVEROUTPUT ON; 


DECLARE 
imagei BLOB; 
image2 BLOB; 
compare result NUMBER; 
BEGIN 


SELECT product_image 
INTO imagel 

FROM product_images 
WHERE product id = 1; 


SELECT product image 
INTO image2 

FROM product images 
WHERE product id = 2; 


compare blobs(imagel, image2, compare result); 


IF compare result » 0 THEN 
DBMS OUTPUT.PUT LINE('The two images are the same!); 
ELSE 
DBMS OUTPUT.PUT LINE('The two images are NOT the same!); 
END IF; 
EXCEPTION 
WHEN OTHERS THEN 
DBMS OUTPUT.PUT LINE(SQLERRM); 
END; 
/ 


Figure 18-11 Ап example that uses the DBMS LOB package 
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Perspective 


In this chapter, you learned how to write LOB types to a database table and 
how to read LOB types from a database type. In addition, you saw an example of 
how to use the Java API to work with LOBs on the client, and you saw an example 
of how to use PL/SQL to work with LOBs on the server. At this point, you have 
the core concepts and skills for working with LOBs. 

Now, if you want to use PL/SQL to do more LOB processing on the server, 
you should be able to do more research on your own. In particular, you may want 
to learn more about the methods of the DBMS LOB package. Keep in mind, 
though, that most LOB processing is done on the client with one of the APIs that 
Oracle provides for working with LOBs. As a result, you usually don't need to use 
the DBMS ТОВ package to do processing on the server. 


Terms 


large object (LOB) 

character large object (CLOB) 

national character large object (NCLOB) 
binary large object (BLOB) 

internal LOB type 

external LOB type 

LOB locator 

chunk size 

block size 

methods of a package 


Exercises 


1. Create a table named Scripts in the EX schema that will contain SQL scripts as 
BFILE data types. The first column should be a number that represents the 
script ID. The second column should be the BFILE value that points to the 
script. 

2. Create a directory reference that points to the directory that contains the SQL 
scripts for chapter 18 (c:\murach\oracle_sql\scripts\ch18). Then, code two 
INSERT statements that insert the first two scripts in that directory into the 
table that you created in exercise 1. 

3. Code a SELECT statement that gets the script IDs and BFILE values for each 
row in the Scripts table that you created in exercise 1. 
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How to install the software 
and source code for this 
book 


Before you begin reading this book, we recommend that you install three 
products: (1) the Oracle Database Express Edition, (2) Oracle SQL Developer, 
and (3) the PDF files for the Oracle's SQL and PL/SQL documentation. All 
three of these products are available for free from the Oracle web site, and you 
can download and install them on your computer as described in this appendix. 

After you install these products, we recommend that you download the 
source files for this book that are available from the Murach web site 
(www,murach.com). Then, we recommend that you run the 
setup database.sql script that creates the users and tables that are used 
throughout this book. 

When you've installed all of the products described in this appendix, 
you're ready to gain valuable hands-on experience by doing the exercises that 
are presented at the end of each chapter. To start, chapter 2 shows how to use 
Oracle SQL Developer to run the SQL statements against the Oracle Data- 
base. Then, as you progress through the rest of the book, you can use SQL 
Developer to open the SQL statements that are installed on your computer 
and run them against the database tables that are installed on your computer. 
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Appendix A Ноу to install the software and source code for this book 


How to install the software from 
oracle.com 


This topic shows how to install three software products that are available for 
free from the Oracle web site. As you read this topic, please keep in mind that it 
only covers the versions of Oracle software that are current as this book goes to 
press. In particular, the current version of the Express Edition of the Oracle 
Database is version 10g. However, version 11g of the Express Edition will 
probably be released in late 2008. 


How to install the Oracle Database Express Edition 


Oracle Database Express Edition (Oracle Database XE) is an entry-level, 
small-footprint database that's free to download and easy to use. Since it is 
designed to run on most modern computers, the Express Edition is ideal for 
developers who want to install it on their own computer so they can learn how to 
work with the Oracle Database. That's why this book assumes that you have 
installed the Express Edition of the Oracle Database on your computer as shown 
in figure А-1. 

When you install the Oracle Database on your computer, you will need to 
specify a password for the system and sys accounts. When you do, make sure to 
remember the password that you enter. If security isn't a concern for you as 
you're learning, we recommend using “system” as the password. That way, it will 
be easy to remember the password. In addition, the password will match the 
password that's specified by the scripts that create the users and tables for this 
book as described in figure A-5. 

АП of the SQL statements presented in this book have been tested against the 
10g and 11g versions of the Oracle Database. As a result, you can use the skills 
presented in this book to work with either version of the database. So when the 
Express Edition of version of 11g is released, you can install and use that version 
instead of 10g. 
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The URL for the Oracle Database 


http://www.oracle.com/technology/software/products/database/index.html 


The Install Wizard for the Express Edition of the Oracle Database 


Oracle Database 10g Express Edition - Install Wiz... Ж) 


Welcome to the InstallShield Wizard for Oracle 
Database 10g Express Edition 


The InstallShield? Wizard will install Oracle Database 10g 
Express Edition on your computer. To continue, click 
Next. 


ORACLE’ 


DATABASE 
EXPRESS EDITION 


How to download and install the Express Edition of the Oracle Database 


L 


Find the download page for the Express Edition of the Oracle Database. This page is 
currently available at the URL shown above. If necessary, you can search the Internet 
for “Oracle 10g Express Edition download” or “Oracle 11g Express Edition download.” 


Follow the instructions provided on that web page to download the setup file to your 
hard drive. 


Find the setup file on your hard drive and run it. 


Respond to the resulting Install Wizard dialog boxes. When these dialog boxes ask you 
to specify a password for the system and sys accounts, make sure to remember the 
password that you enter. If security isn't a concern for you as you're learning, we 
recommend using "system" as the password. 


When you finish the Install Wizard dialog boxes, the Database Login screen for the 
Oracle Database will be displayed by default. To make sure the database has been 
installed correctly, use the password you entered in step 4 to log in to the database as the 
system user. 


Notes on the Express Edition for 11g 


Since the Express Edition of Oracle Database 11g hasn't been released as of the print 
date for this book, this figure shows how to install Oracle Database 10g. However, when 
the Express Edition of Oracle Database 11g becomes available, you should be able to 
use a similar procedure to install it. 


Figure A-1 How to install the Oracle Database Express Edition 
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How to install Oracle SQL Developer 


In the past, it was common for developers to use a command-line tool 
known as SQL*Plus to work with Oracle databases. Although you can still use 
SQL *Plus, Oracle has recently created a free graphical tool known as Oracle 
SQL Developer that makes it easier to work with Oracle databases. Since SQL 
Developer is an ideal tool for learning how to work with Oracle, we recommend 
that you download and install it as described in figure А-2. Then, you can learn 
how to use it in chapter 2, and you can use it to work with the SOL statements 
that are presented throughout this book. 

Unlike many software programs, SQL Developer doesn't require an install 
program. Instead, you install it by downloading a zip file and unzipping that file 
onto your hard drive. Then, you can run SQL Developer by running the exe file 
for the program. To make that easier, you can create a shortcut to this file and 
add it to your Start menu or desktop. 

Although this figure assumes that you're using Microsoft Windows as your 
operating system, the Oracle web site provides documentation for installing 
SQL Developer on most modern operating systems. For example, you can get 
more information about installing SQL Developer on Linux or Macintosh OS X 
from the Oracle web site. 
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The URL for Oracle SQL Developer 


http://www.oracle.com/technology/software/products/sql/index.html 


The SQL Developer files after they have been downloaded and unzipped 


Fla Edt View Favorites Tools Нер 


Back * Search Folders X 
3 24 СЕЕ 
Address OC; Program Presitodeveloper 
Folders 
EJ 5 SonicWALL 
E CJ saldevsloper 
D (2) Вс 
E (Cu det 
E C3 ide 
E (C jzee 
E (C jdbc 


E (C jdev 
jib Caisaldeveloper 


E (Ca lib Eee 
EJ и rdbms Ай соп. 
EJ (27 saldeveloper Е) readme. tet 

Lj зто титли 


How to download and install Oracle SQL Developer 


1. Find the download page for SQL Developer. This page is currently available at the URL 
shown above. If necessary, you can search the Internet for “Oracle SQL Developer 
download." 


2. Follow the instructions provided on that web page to download SQL Developer. Since 
SQL Developer only works with certain versions of Java, we recommend that you 
download the version that includes the JDK whenever possible. 


3. Install SQL Developer by unzipping it. On a Windows system, we recommend unzip- 
ping it into the C:\Program Files directory as shown above. 


4. Once you have unzipped the zip file for SQL Developer, you can start SQL Developer 
by executing the sqldeveloper.exe file. To do that on a Windows system, you can use the 
Windows Explorer to double-click on the sgldeveloper.exe file. If you followed our 
recommendation in step 3, this file should be in the C:\Program Files\sqldeveloper 
directory as shown above. 


Notes 


e To make it easy to start SQL Developer, you may want to manually create a shortcut to 
the sqldeveloper.exe file and add it to your Start menu or desktop. Once you do that, you 
can start SQL Developer just like you start your other programs. 


Figure A-2 How to install Oracle SQL Developer 
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How to install the SQL documentation 


If you want to view the SQL documentation for Oracle Database, you can 
view it in a web browser just by navigating to the correct URL on the Oracle 
web site. Then, you can view this documentation as HTML pages or a PDF file. 
However, you can also use the procedure in figure А-3 to save the PDF file on 
your own computer. 

There are two benefits to saving the PDF file on your computer. First, you 
can browse or search this documentation more quickly than you can when 
you're using an Internet connection. Second, you can browse or search this 
documentation even if you aren't connected to the Internet. 

The name of the SQL documentation may vary depending on the version of 
Oracle that you're using. For Oracle 10g, the name of this manual is the SQL 
Reference. For Oracle 11g, the name of this manual is the SQL Language 
Reference. 


How to install the PL/SQL documentation 


If you want to view or install the PL/SQL documentation, you can use a 
procedure like the one for installing the SQL documentation. However, to find 
the PL/SQL documentation, you may need to click on the "Application Devel- 
opment" link. 

Like the SQL manual, the name of the PL/SQL manual may vary depending 
on the version of Oracle. For Oracle 10g, the name of this manual is the PL/SQL 
User's Guide and Reference. For Oracle 11g, the name of this manual is the PZ/ 
SQL Language Reference. 
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The URL for the Oracle Database documentation 


http://www.oracle.com/technology/documentation/index.html 


How to download and install the SQL documentation 


1. 


Find the download page for the Oracle Database documentation that you want to 
download. For example, the documentation for Oracle Database 11g Release 1 is 
currently available from this URL: 
http://www.oracle.com/pls/dblll/homepage 


Click on the PDF link for the SQL Reference (10g) or SQL Language Reference (11g) to 
open the document (it may take you a while to find this link because the page has many 
options). Then, use the File3 Save As command to save the document on your computer. 
This command opens the Save a Copy dialog box. There, you can save the manual in 
whatever directory you want and with whatever name you want. 

To view the documentation after you have saved it to your computer, open the PDF file 


in the Adobe Reader. On most Windows systems, you can do that by using the Windows 
Explorer to double-click on the PDF file. 


How to download and install the PL/SQL documentation 


Follow the same steps for downloading the SQL User's Guide and Reference (10g) or 
SQL Language Reference (11g). However, before step 2, you may need to click on the 
"Application Development" link or folder to display the page that contains the link to the 
PDF file. 


Note 


To make it easy to start these PDF files, you can create a shortcut for the file and add it 
to your Start menu or desktop. Then, you can start the PDF file just like you start your 
other programs. 

To install the Adobe Reader, you can visit Adobe's web site (www.adobe.com) and 
follow the directions there for installing the Adobe Reader. 


Figure A-3 How to install the Oracle Database SQL and PL/SQL manuals 
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How to install the software from 
murach.com 


Once you have installed the Oracle software products, we recommend that 
you install the source files for this book. In addition, we recommend that you 
create the users and tables that are used by the examples in this book. 


How to install the source files for this book 


Figure А-4 shows how to install the source files for this book. These source 
files include SQL scripts that contain the SQL code for all of the examples in 
this book. These files also include SQL scripts that you can use to create the 
tables and users that are used by the examples in this book. 

The source files for this book are contained in a self-extracting zip file (an 
exe file) that you can download from www.murach.com. When you download 
and execute this zip file, it will unzip the SQL script files for the book into the 
C:\murach\oracle_sql directory. Within this directory, the scripts directory 
contains the SQL code that's presented in this book. 
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The default installation directory for the source files 


C:\murach\oracle sql 


How to download and install these files 
1. Go to www.murach.com, and go to the page for Murach’s Oracle SQL and PL/SQL. 
2. Click the link for “FREE download of the book examples.” 


3. Select the “All book files” link and respond to the resulting pages and dialog boxes. This 
will download a setup file named osql_allfiles.exe onto your hard drive. 


4. Use the Windows Explorer to find the setup file on your hard drive. 


5. Double-click this file and respond to the dialog boxes that follow. If you accept the 
defaults, this installs the files into the directory shown above. 


The source files that get installed into the oracle sql subdirectories 
Directory Description 


db_setup The batch files and scripts that are used to create the database tables and users for the 
examples in this book. 


scripts The scripts for all of the examples presented in this book. 
Description 


e All of the source files described in this book are in a self-extracting zip file (an exe file) 
that can be downloaded from www.murach.com. 


Figure A-4 How to install the source files for this book 
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How to create the tables and users for this book 


Before you can run the SQL statements presented in this book, you need to 
create the appropriate tables and users on the database server. The easiest way to 
do that is to run the setup. database.bat file described in figure А-5. When you 
run this file, it executes a script named setup. database.sql that creates the three 
users listed in this figure along with all of the appropriate tables for each user. 

Keep in mind that the setup, database.bat file will work correctly only if you 
have specified "system" as the password for the system user when you installed 
Oracle Database. If that's not the case, you can edit the setup database.bat file 
to replace system with the correct password before you run this file. Or, you can 
enter the correct username and password at the prompt that's displayed after the 
invalid username/password message is displayed. 

Similarly, the setup. database.bat file will work correctly only if your 
computer is able to find the correct version of the SQL*Plus application. Most 
of the time, your computer will be able to automatically find this application. 
However, if your computer can't find the correct version of the SQL*Plus 
application, you can edit the setup. database.bat file and supply a complete path 
to the SQL*Plus application as shown in this figure. Here, the path points to the 
version of SQL*Plus that comes with the Express Edition of Oracle Database 
10g, but you can use a similar path to point to the version of SQL*Plus that 
comes with other editions and versions of the Oracle Database. 


How to restore the tables and users 


As you work with the examples in this book, you may make changes to the 
users or tables that you don't intend to make. In that case, you may want to 
restore the users and tables to their original state so your results will match the 
results shown in this book. To do that, you can run the setup database.bat file a 
second time. This will drop the three users described in this figure and all tables 
available to those users, and it will recreate these three users and all tables 
available to those users. 


Appendix А How to install the software and source code for this book 


The directory that contains the setup database.bat file 
C:\murach\oracle_sql\db setup 


The users that are created 
Description 


The user that corresponds with the AP (Accounts Payable) schema. This is the primary schema 
that’s used in this book. 


The user that corresponds with the OM (Order Management) schema. This schema is used in some 
of the examples in this book. 


The user that corresponds with the EX (Examples) schema. This schema contains several tables 
that are used for short examples. 


How to create the tables and users for this book 


1. Use the Windows Explorer to find the setup_database.bat file in the directory shown 
above. 


2. Double-click this file to run it. This should display a DOS window that indicates the 
status of the task. 


3. When the bat file finishes, press any key to continue. 


4. To check to see whether all the tables and users were installed correctly, open the 
setup_database.log file that’s in the directory shown above. 


How to restore the tables and users for this book 


e Run the procedure for creating the tables and users again. This will drop all of the tables 
and users before creating them again. 


How to modify the setup_database.bat file to specify the complete path 
for the SQL*Plus directory (not usually necessary) 
C:\oraclexe\app\oracle\product\10.2.0\server\BIN\sqlplus 


Description 


e For the setup_database.bat file to work, it must specify the correct password for the 
system user. This password is set to “system” in the bat file, but you can open this bat 
file in a text editor and edit the password if necessary. Or, you can enter the correct 
username and password after an invalid username/password prompt is displayed. 


e For the setup_database.bat file to work, the database server must be running. By default, 
the database server is automatically started when your start your system. If it isn’t 
running on your system, you can start it as described in chapter 2. 


Figure A-5 How to create and restore the tables and users for this book 
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Appendix В 


How to install the Standard 
or Enterprise Edition of 
Oracle Database 


Before you begin reading this book, we recommend that you install the Express 
Edition of the Oracle Database as described in appendix A. We recommend this 
edition of Oracle because it is ideal for developers who want to install Oracle 
Database on their own computers so they can learn how to work with it. 

However, if you have a compelling reason to install the Standard Edition 
or the Enterprise Edition of the Oracle database, you can use this appendix to 
install one of those editions. Fortunately, if you join the Oracle Technology 
Network (OTN), you can download these editions of the database for evalua- 
tion purposes for free. Unfortunately, these editions take longer to download 
and install and require more system resources than the Express Edition. 

In addition, the Standard and Enterprise Editions are designed to be 
accessed from across a network. As a result, they may require some addi- 
tional configuration before they will work properly for standalone use on 
your computer. This appendix shows how to configure these editions for 
standalone use on Windows XP. However, for other operating systems, you 
may need to search the Internet to find out how to configure your system 
properly. 

Finally, when you use the Standard or Enterprise Edition, you need to use 
a different procedure for creating a connection for SQL Developer than the 
procedure that's described in chapter 2. That's why this appendix finishes by 
describing how to create a connection between SQL Developer and these 
editions of the Oracle Database. 


How to install the Standard or Enterprise Edition of Oracle Database ........... 604 
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How to connect SQL Developer to the Standard or Enterprise Edition .......... 610 


604 


Appendix B Ноу to install the Standard and Enterprise Editions of Oracle Database 


How to install the Standard or Enterprise Edition 


of Oracle Database 


You can use the procedure shown in figure B-1 to install Oracle Database 
Standard Edition or Oracle Database Enterprise Edition. As mentioned earlier, if 
you join the Oracle Technology Network (OTN), you can download these 
editions for free for evaluation purposes. Joining the OTN is also free and only 
takes a few minutes. 

Before you run the setup file for the database, you should consider how you 
intend to use the database. If you want to run the database on your computer 
and also access it from a client that's running on your computer, you may need 
to install a network adapter. With Windows XP, for example, you must install 
the Microsoft Loopback Adapter as described in the next figure before you 
continue with step 4 in this figure. On the other hand, if you want to run the 
database on one computer and access it from a client that's running on another 
computer, you might not need to install a network adapter. In that case, you can 
skip the next figure. 

When you install Oracle Database, you will need to specify a password for 
the system and sys accounts. When you do, make sure to remember the pass- 
word that you enter. If security isn't a concern for you as you're learning, we 
recommend using "system" as the password. That way, it will be easy to 
remember the password. In addition, the password will match the password 
that's specified by the scripts that create the users and tables for this book as 
described in figure А-5 of appendix A. 
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The URL for the download page for Oracle Database 


http://www.oracle.com/technology/software/products/database/index.html 


The Oracle Database Installation dialog box 


* Oracle Database aig | nstallation - Select a Product to Install. 


ORACLE 1 1 g 


Select Installation Method DATABASE 


8 Basic Installation 


Perform full Oracla Database 11g installation with standard configuration options requiring minimal input. 
This option uses fila system for storage, and a single password for all database accounts, 


Oracle Base Location: | C:oraclet 1g Ё Browse... | 
Oracle Ната Location: [слагает giproductt 1.1.0061 ———————————— Browse... | 
installation Type: Standard Edition (2.8GB) X 
Iv Create Starter Database (additional 1482МВ) 


Global Database Nama: farci 
i r 
Database Password: = Confirm Password: [rre 


This password is used for the SYS, SYSTEM, SYSMAN, and DBSNMP accounts. 


C Advanced Installation 


Allows advanced selections such as different passwords forthe 878, SYSTEM, SYSMAN, and DBSNMP 
accounts, database character set, product languages, automated backups, custom Installation, and 
alternative storage options such as Automatic Storage Management. 


Help | Back Next Install Сапса! ) 


How to download and install Oracle Database 


l. 


Find the download page for the Standard Edition or Enterprise Edition of Oracle 
Database. This page is currently available at the URL shown above. 


Follow the instructions provided on that web page to download the setup file to your 
hard drive. If you aren't already a member of the Oracle Technology Network (OTN), 
you may need to join the OTN. 


If you are installing Oracle Database on a computer that isn't connected to a network, 
you need to install the Microsoft Loopback adapter as described in figure B-2 before 
you continue. 


Find the setup file on your hard drive and run it. 


Respond to the resulting Oracle Universal Installer dialog boxes. 


When you specify the base location, don't use spaces in the directory name. 


When these dialog boxes ask you to specify a password for the system and sys 
accounts, make sure to remember the password that you enter. If security isn't a 
concern for you as you're learning, we recommend using "system" as the password. 


Description 


The Standard and Enterprise Editions take longer to download and install than the 
Express Edition. In addition, they require more system resources. Аз a result, we recom- 
mend using the Express Edition whenever possible. 


Figure B-1 How to install the Standard or Enterprise Edition of Oracle Database 
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How to configure Windows XP for standalone use 


Figure B-2 shows how to configure Windows XP so you can run the data- 
base on your computer and access it from a client that's also running on your 
computer. To make that possible, you must install the Microsoft Loopback 
Adapter. Although the procedure for installing this adapter is long, it only takes 
a few minutes to complete if everything goes smoothly. Of course, if you 
encounter problems, it can be time-consuming to troubleshoot the problem. 

Note that the steps in part 3 of this figure are optional for some systems. А$ 
a result, I recommend that you attempt to use SQL Developer to connect to the 
database after you restart the computer as described in step 19 of this procedure. 
To do that, you can use the procedure shown in the next figure. Then, if you're 
able to connect successfully, you can skip the steps in part 3 of this figure. In 
addition, if you need to complete the steps in part 3 of this figure, you may want 
to enlist the help of your network administrator as these steps could affect your 
access to other network resources. 
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How to install the Microsoft Loopback Adapter on Windows XP (part 1) 
Install the Loopback Adapter 


1. 


2. 
3, 
4 


9. 


Open the Windows Control Panel and switch to Classic View. 
Double-click on the Add Hardware icon to start the Add Hardware wizard. 
In the Welcome window, click the Next button. 


In the "Is the hardware connected?" window, select the “Yes, I have already 
connected the hardware" option, and click the Next button. 


In the "The following hardware is already installed on your computer" window, go 
to the list of installed hardware, select the "Add a new hardware device" option, and 
click the Next button. 


In the "The wizard can help you install other hardware" window, select the "Install 
the hardware that I manually select from a list" option, and click the Next button. 


From the list of hardware types, select the type of hardware you are installing, select 
the "Network adapters" option, and click the Next button. 


In the Select Network Adapter window, make the following selections: 
e Manufacturer: Microsoft. 

e Network Adapter: Microsoft Loopback Adapter. 

Click the Next button. 


10. In the "The wizard is ready to install your hardware" window, click the Next button. 
11. In the Completing the Add Hardware Wizard window, click the Finish button. 


Figure B-2 How to install the Microsoft Loopback Adapter (part 1 of 3) 
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How to install the Microsoft Loopback Adapter on Windows XP (part 2) 

Configure the Loopback Adapter 

12. Open the Windows Control Panel and switch to Classic View. 

13. Double-click on the Network Connections icon. This displays the Network 
Connections window. 

14. Right-click the connection that was just created (usually named "Local Area 
Connection 2"), and choose the Properties command. 

15. On the General tab, select the Internet Protocol (TCP/IP) item, and click the 
Properties button. 

16. In the Properties dialog box, click "Use the following IP address" and specify an IP 
address and subnet mask as shown here: 


Internet Protocol (TCP/IP) Properties 


You can get ІР settings assigned automatically if your network supports 
this capability. Otherwise, you need to ask your network administrator for 
the appropriate IP settings. 


С) Obtain an ІР address automatically 

48) Use the following IP address: 
IP address: 
Subnet mask: 
Default gateway: р о 


(8) Use the following DNS server addresses: 
Prefered DNS server: 


Alternate DNS server: 


17. Click the OK button to accept the new settings. 
18. Close the Network Connections window. 
19. Restart the computer. 


20. Start Oracle SQL Developer and attempt to create a connection to the database as 
described in figure B-3. If you are able to create a connection, you can skip the rest 
of this procedure. 


Figure B-2 How to install the Microsoft Loopback Adapter (part 2 of 3) 
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How to install the Microsoft Loopback Adapter on Windows XP (part 3) 

Check the network configuration (not always necessary) 

21. Open the Windows Control Panel and switch to Classic View. 

22. Double-click on the System icon to display the System Properties dialog box. Then, 
select the Computer Name tab. In the “Full computer name" label, make a note of 
the host name and the domain name. For example, the full computer name may be 
something like joel.murach.corm. In that case, the host name is joel and the domain 
name is murach.com. 


23. If necessary, you may be able to use the Change button to change these settings. 
However, you may want to contact your network administrator before you make any 
changes as that may affect your access to network resources. 

Edit the hosts file (not always necessary) 

24. Open the C:\WINDOWS\system32\drivers\etc\hosts file in a text editor. 

25. Add a line after the localhost line that specifies the IP address for the Loopback 
Adapter and the name and domain name for the computer using this syntax: 
IP address host name.domain name host name 
For example: 
10.10.10.10 joel.murach.com joel 

26. Save your changes to the text file. 


Figure B-2 How to install the Microsoft Loopback Adapter (part 3 of 3) 


610 Appendix B How to install the Standard and Enterprise Editions of Oracle Database 


How to connect SQL Developer to the Standard or 
Enterprise Edition 


Figure B-3 shows how to use SQL Developer to connect to the Standard or 
Enterprise Edition of the Oracle database. This procedure is similar to the 
procedure shown in figure 2-4 of chapter 2. However, instead of using a Basic 
connection type, you typically need to select the TNS connection type. Then, 
you must select the appropriate network alias, which is usually ORCL. 
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The SQL Developer dialog box for creating a database connection 
SS туану Г 


Connection Мате Connection Details | Connection Name |= 
Username 
Password 


[C Save Password 


Oracle|(Access [Муз [SQLServer] C — 
z 


Connection Type (7 Basic (®) TNS C) Advanced 


(9) Network Allas ORCL 


С) Connect Identifier 


Status : Success 


29 Јале (саа 1 


How to create а database connection 
1. Start Oracle SQL Developer. 


2. Right-click on the Connections node in the Connections window and select the New 
Connection command to display the dialog box for creating database connections. 


Enter a connection name, username, and password for the connection. 
Select the TNS connection type from the Connection Type list. 
Select the network alias for the database from the Network Alias list. 


Click the Test button to test the connection. If the connection works, a success message 
is displayed above the Help button. 


7. Click the Save button to save the connection. When you do, the connection will be 
added to the dialog box and to the Connections window. 


Qv ACA. Б Оз 


Description 


e With the Standard or Enterprise Edition of the Oracle database, the procedure for creat- 
ing a database connection with SQL Developer is a little different than the procedure 
shown in figure 2-4 of chapter 2. 


Figure B-3 How to connect SQL Developer to the Standard or Enterprise Edition 
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/ operator, 91 
/*...*] characters (block comment), 32, 33 
GECHO OFF command, 442, 443 
_ wildcard character, 108, 109 
+ operator, 91 
< operator, 100, 101 
<= operator, 100, 101 
<> operator, 100, 101 
= operator, 100, 101 
> operator, 100, 101 
>= operator, 100, 101 
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ABS function, 257 
Action query, 28, 29 
ActiveX Data Objects (ADO), 38, 39 
Ad hoc relationship, 120, 121 
ADD CONSTRAINT clause (ALTER TABLE), 322, 323 
ADD_MONTHS function, 260, 261 
Addition operator, 91 
Admin user 

creating a user, 370, 371 

creating a connection, 372, 373 
ADO (ActiveX Data Objects), 38, 39 
ADO.NET, 38, 39 
AFTER EACH ROW block, 518, 519 
AFTER STATEMENT block, 518, 519 
AFTER trigger, 504, 505, 510, 511 
Aggregate function, 92, 160-163 
Alias 

column, 86, 87 

in ORDER BY, 114, 115 

table, 122, 123 
All columns operator (*), 84, 85 
ALL keyword 
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subquery, 188, 189 

in aggregate function, 160, 161 

in SELECT, 85, 97 

in UNION, 150, 151 

to grant privileges, 384, 385 

to revoke privileges, 386, 387 
ALL TRIGGERS keywords, 516, 517 
ALTER (DDL event), 513, 514 
ALTER DATABASE statement, 534, 535 
ALTER INDEX statement, 21 
ALTER SEQUENCE statement, 21, 330, 331 
ALTER SESSION statement, 534, 535 
ALTER TABLE statement, 21, 320-323 
ALTER TRIGGER statement, 516, 517 
ALTER USER staternent, 21, 380, 381 
ALTER VIEW statement, 364, 365 
Ambiguous column name, 120, 121 
American National Standards Institute (ANSD, 16, 17 
AND operator, 102, 103 
Anonymous PL/SQL block, 410, 411 
ANSI (American National Standards Institute), 16, 17 
ANSUISO SQL, 17 
ANSI-standard 

data type, 230, 231 

SQL, 16, 17 
ANY keyword, 190, 191 
API, 6, 7 

data access, 6, 7 

with LOBs, 562, 563 
Apostrophes, 89 
APPEND method, 586, 587 
Application error, 472, 473 
Application programming interface (API), 6, 7 
Application 

server, 8, 9 

software, 6, 7 
Arithmetic expression, 90, 91 
Arithmetic operator, 90, 91 
AS clause 

CREATE VIEW, 354, 355 

SELECT clause, 84-87 
AS keyword 

in FROM clause, 122, 123 

in SELECT, 87 
ASC keyword (ORDER BY clause), 112, 113 
Ascending sequence, 112, 113 
ASCII character set, 232, 233 
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Associate table 


Associate table, 292, 293 
Associative array, 427-429 

Asterisk (*) (SELECT clause), 84-85 
Attribute, 284, 285, 312, 313 
Autocommit, 214, 215 

AVG function, 160-163 


Back end, 7 

Back-end processing, 7 

Base table, 24, 25, 80, 81, 350, 351 

BCNF, 300, 301 

BEFORE EACH ROW block, 518, 519 

BEFORE STATEMENT block, 518, 519 

BEFORE trigger, 504, 505 

BEGIN keyword, 410, 411 

BETWEEN operator, 106, 107 

BFILE (Binary File) data type, 238, 239, 562, 563, 568, 
569 

BFILENAME function, 568, 569 

Binary File (BFILE) data type, 238, 239, 562, 563, 568, 
569 

Binary large object (BLOB) data type, 238, 239, 562, 
563, 566, 567 

BINARY, DOUBLE data type, 234, 235, 258 

BINARY, FLOAT data type, 234, 235 

BINARY, INTEGER keyword, 428, 429 

Bind variable, 436, 437 

BLOB (Binary Large Object) data type, 238, 239, 562, 
563, 566, 567 

Block comment, 32, 33 

Block size, 570, 571 

Body of a package, 488, 489 

Boolean expression, 80-82, 418, 419 

Boyce-Codd normal form (BCNF), 300, 301 

Breakpoint, 496-499 

Browser (web), 8, 9 

Built-in function, 36 

BULK COLLECT clause, 428, 429, 522, 523 

Business component, 8, 9 


Cc 


C#, 38, 39 
CACHE option, 570, 571 
Calculated value, 24, 25, 84, 85 
assigning name, 86, 87 
CALL statement, 464, 465 
Cartesian product, 148, 149 
Cascade, 316, 317 
CASCADE keyword (DROP USER), 371, 372 
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Cascading delete, 316, 317 
CASE expression 
in SELECT statement, 268, 269 
searched, 269 
simple, 269 
CASE function, 268, 269 
Case sensitivity, 100, 101 
CASE software tool, 290, 291 
CASE statement, 420, 421 
CASE...WHEN...ELSE keywords, 413 
CAST function, 240, 241 
catch block (Java), 42 
CEIL function, 256, 257 
Cell, 10, 11 
Changes 
commit, 214, 215 
rollback, 214, 215 
CHAR data type, 15, 231-233 
CHAR VARYING data type, 230, 231 
Character 
conversions, 240-242, 246, 247 
data, 248-255 
data type, 230-233 
functions, 248-251 
Character large object (CLOB) data type, 238, 239, 
562-565 
Check constraint, 318, 319 
CHR function, 246, 247 
Chunk size, 570, 571 
Classpath, 40 
Client, 4, 5 
software, 6, 7 
Client/server system, 4, 5, 7, 8 
CLOB (Character Large Object) data type, 238, 239, 
562-565 
CLOSE method, 586, 587 
closeConnection method (Java), 584, 585 
closePreparedStatement method (Java), 584, 585 
closeResultSet method (Java), 584, 585 
COALESCE function, 270, 271 
Codd, E.F., 10, 16, 17 
Code completion feature, 62, 63 
Coding recommendations, 32, 33 
Collection, 426, 427 
Column, 10, 11 
alias, 86, 87 
ambiguous name, 120, 121 
function, 160, 161 
list (with INSERT), 216, 217 
naming, 86, 87 
position (in ORDER BY), 114, 115 
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qualified name, 120, 121 

specification, 84, 85, 86 

value, 96, 97 
Column definition 

editing, 60, 61 

viewing, 58, 59 
Column-level constraint, 314, 315 
Command object (Java), 40 
Comment, 32, 33 
Commit, 448, 449 
COMMIIT statement, 34, 35, 214, 215, 448, 449 
COMPARE method, 587 
Comparison operator, 100, 101 
Compile, 462, 463 

function, 494, 495 

procedure, 494, 495 
Complex query, 200-203 
Compliance with SQL-92, 16, 17 
Composite 

index, 298, 299 

primary key, 10, 11 
Compound condition, 102, 103 
Compound join condition, 126, 127 
Compound search condition, 170, 171 
Compound trigger, 518, 519, 522, 523 
Computer-aided software engineering (CASE), 290, 291 
Concatenation, 84, 85, 88, 89 

operator, 88, 89 
Concurrency, 452-457 
Condition 

compound, 102, 103 

compound join, 126, 127 

join, 120, 121 
CONNECT BY clause, 206, 207 
CONNECT command, 52, 53, 370, 371, 412, 413 
CONNECT role, 400 
Connecting table, 292, 293 
Connection Information dialog box, 57 
Connection object (Java), 40 
Connections list, 62, 63 
Connections window, 54, 55 
Constraint, 22, 23, 314-319 

adding, 322, 323 

disabling, 322, 323 

dropping, 322, 323 

enabling, 322, 323 

FOREIGN KEY, 294, 295 

in SQL Developer, 340, 341 
CONSTRAINT keyword, 314-317 
CONTINUE statement, 422, 423 
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CONTINUE WHEN statement, 422, 423 

Control character, 246, 247 

CONVERTTOBLOB method, 586, 587 

Coordinated Universal Time (UTC), 532, 533 

COPY method, 587 

Core specification (SQL-99 standard), 16, 17 

Correlated subquery, 192, 193, 198, 199 

Correlation identifier, 504-506 

COUNT function, 160-163 

COUNT method, 426, 427, 428, 429 

CREATE ANY TABLE privilege, 378, 379 

CREATE DIRECTORY statement, 568, 569 

CREATE FUNCTION statement, 36, 37 

CREATE INDEX statement, 21, 326, 327 

CREATE PACKAGE BODY statement, 488, 489 

CREATE PACKAGE statement, 488, 489 

CREATE PROCEDURE privilege, 379 

CREATE PROCEDURE statement, 34, 35, 462, 463 

CREATE PUBLIC SYNONYM privilege, 374, 375, 
390, 391 

CREATE PUBLIC SYNONYM statement, 390, 391 

CREATE ROLE statement, 374, 375, 382, 383 

Create sample tables, 600, 601 

CREATE SEQUENCE privilege, 379 

CREATE SEQUENCE statement, 21, 328, 329 

CREATE SESSION privilege, 374, 375 

CREATE SYNONYM privilege, 388, 389 

CREATE SYNONYM statement, 388, 389 

CREATE TABLE AS statement, 213 

CREATE TABLE privilege, 378, 379 

CREATE TABLE statement, 21, 212, 213, 312-319 

CREATE TRIGGER statement, 504, 505 

Create User command, 50, 51 

CREATE USER statement, 21, 370, 371, 374, 375, 380, 
381 

CREATE VIEW privilege, 379 

CREATE VIEW statement, 30, 31, 350, 351, 354, 355, 
364, 365 

CREATE (DDL event), 513, 514 

CREATETEMPORARY method, 587 

Creating a database connection, 54, 55 

Cross join, 148, 149 

CUBE operator, 174, 175 

in GROUP BY clause, 272, 273 

CURRENT. DATE function, 260, 261, 536, 537 

CURRENT TIMESTAMP function, 540, 541, 548, 549 

CURRVAL pseudo column, 328, 329 

Cursor, 424, 425 

CURSOR...IS keywords, 413 
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D Date search, 264, 265 
Date/time data type, 230, 231, 236, 237, 260-267 
Data converting, 240-242 
derived, 306, 307 format elements, 244, 245, 546, 547 
element, 286-289 functions, 260, 261 
of a table, 338, 339 parsing examples, 263 
printing to an output window, 414, 415 DB2 (Database 2), 16, 17 
structure, 284, 285 compared to SQL Server and Oracle, 18, 19 
Data access API, 6, 7 DBA (Database administrator), 20, 21 
Data access model, 38, 39 DBMS, 6,7,9 
Data consistency (trigger), 506, 507 DBMS LOB package 
Data definition language (DDL), 20, 21 example, 588, 589 
Data element methods, 586, 587 
identifying, 286, 287 DBMS OUTPUT package, 412, 413 
subdividing, 288, 280 ENABLE procedure, 413 
Data manipulation language (DML), 20, 21 PUT procedure, 413 
Data redundancy, 296, 297 PUT LINE procedure, 413 
Data type, 14, 15, 230-239 DBMS SQL package, 438, 439 
ANSI-standard, 230, 231 DBTIMEZONE function, 532, 533, 536, 537 
converting, 240-242 DDL (Data definition language), 20, 21, 22 
Data validation, 470-473 event 513, 514 
Database 2, 16, 17 trigger, 513, 514 
designing, 284-310 Deadlock, 458, 459 
engine, 48, 49 Debug 
relational, 10, 11 function, 496-499 
server, 4, 5, 9, 48, 49 procedure, 496-499 
Database administrator (DBA), 20, 21 DEBUG privilege, 384, 385 
Database connection Debugger, 496-490 
creating, 54, 55 Debugging, 496-499 
exporting, 54, 55 DECIMAL data type, 230, 231 
importing, 54, 55 Declarative referential integrity (DRI), 294, 295 
Database event (trigger), 513, 514 DECLARE keyword, 410, 411 
Database Home Page, 50, 51 Default 
DATABASE keyword (trigger), 513, 514 date format, 534, 535 
Database listener, 48, 49 time zone, 534, 535 
Database management system (DBMS), 6, 7 value, 14, 15 
Database object, 20, 21, 22 DEFAULT attribute, 312-315 
dropping without displaying errors, 434, 435 DEFAULT keyword 
in SQL Developer, 338, 339 with INSERT statement, 218, 219 
navigation, 56, 57 with parameters, 468, 469 
Database security, 370-404 DEFAULT TABLESPACE clause (CREATE USER), 
Database server, 9 380, 381 
Database service, 48, 49 DELETE privilege, 374, 375, 379 
Database settings, 534, 535 DELETE statement, 21, 28, 29, 226, 227 
Database system, 16, 17, 18 through view, 362, 363 
Database time zone, 532, 533 DELETING trigger predicate, 510, 511 
Date comparison, 106, 107 Denormalization, 308, 309 
Date component, 263 DENSE_RANK function, 274-277 
DATE data type, 15, 230, 231, 236, 237, 260-267, see Dependency, 300, 301 
also Date/time data type Derived data, 306, 307 


Date literal, 100, 101 DESC keyword (ORDER BY), 112, 113 


Descending sequence 


Descending sequence, 112, 113 
Designing a database, 284-310 
Dialect, SQL, 16, 17 
Dirty read, 454, 455 
DISABLE CONSTRAINT clause (ALTER TABLE), 
322, 323 

DISABLE STORAGE IN ROW, 570, 571 
DISTINCT keyword 

affect on ORDER BY clause, 112, 113 

in aggregate function, 160-163 

in SELECT, 84, 85, 96, 97 

in self-join, 128, 129 
Division operator, 91 
DKNF, 300, 301 
DML (data manipulation language), 20, 21 
Domain-key normal form (DKNF), 300, 301 
DOS batch file, 440-443 
DOUBLE PRECISION data type, 231 
Double quotes (alias), 86, 87 
Double-precision, 234, 235 
DRI (declarative referential integrity), 294, 295 
Driver, 38, 39 
DriverManager class (Java), 40 
DROP (DDL event), 513, 514 
DROP ANY TABLE privilege, 378, 379 
DROP DIRECTORY statement, 568, 569 
DROP FUNCTION statement, 486, 487 
DROP INDEX statement, 21, 326, 327 
DROP PACKAGE BODY statement, 490, 491 
DROP PACKAGE statement, 490, 491 
DROP PROCEDURE statement, 480, 481 
DROP PUBLIC SYNONYM statement, 390, 391 
DROP ROLE statement, 382, 383 
DROP SEQUENCE statement, 21, 330, 331 
DROP SYNONYM statement, 388, 389 
DROP TABLE privilege, 378, 379 
DROP TABLE statement, 21, 212, 213, 324, 325 
DROP TRIGGER statement, 516, 517 
DROP USER statement, 21, 370, 371, 380, 381 
DROP VIEW statement, 364, 365 
Dual table, 94, 95 
DUP VAL, ON INDEX exception, 432, 433 
Duplicate rows (eliminating), 96, 97 
Dynamic SQL, 438, 439 


ECHO command, 442, 443 

Edit Table dialog box, 60, 61 
Element (data), 286-289 

EMPTY BLOB function, 566, 567 


EXTRACT function 


EMPTY. CLOB function, 564, 565 
ENABLE CONSTRAINT clause (ALTER TABLE), 
322, 323 
ENABLE procedure, 412, 413 
ENABLE STORAGE IN ROW option, 570, 571 
END keyword, 410, 411 
End user, 374, 375 
Engine (database), 48, 49 
Entering SQL script, 70, 71 
Enterprise Edition (Oracle Database) 
connecting, 610, 611 
installing, 604, 605 
Enterprise system, 4, 5 
Entity, 284, 285 
Entity-relationship (ER) modeling, 284, 285 
Equal operator, 100, 101 
Equi-join, 144, 145 
ER modeling, 284, 285 
ERASE method, 587 
Error handling, 67, 430, 431 
Error location, 66, 67 
Error number, 66, 67 
Example tables and users, 600, 601 
EXCEPTION block, 430, 431 
Exception handling, 430, 43] 
EXCEPTION keyword, 410, 411 
EXECUTE IMMEDIATE statement, 413, 434, 435 
EXECUTE privilege, 378, 379 
Execute SQL script, 70, 71 
Execute Statement button, 62, 63 
EXISTS method, 428, 429 
EXISTS operator, 194, 195 
EXIT command, 440, 441 
EXIT statement, 422, 423 
EXIT WHEN statement, 422, 423 
Explicit syntax, 120, 121 
Export database connection, 54, 55 
Express Edition of Oracle Database, 48, 49 
installing, 592, 593 
Expression, 84, 85 
arithmetic, 90, 91 
in ORDER BY, 114, 115 
string, 88, 89 
comparing two, 100, 101 
testing 94, 95 
EXTEND method, 428, 429 
Extension (SQL), 16, 17 
External LOB type, 562, 563, 568, 569 
EXTRACT function, 548, 549 
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FF[1-9] element 


FF[1-9] element, 546, 547 
Field, 10, 11 
Fifth normal form (SNF), 300, 301 
File-handling system, 7 
FILECLOSEALL method, 586, 587 
FILEEXISTS method, 586, 587 
FILEGETNAME method, 587 
FILEISOPEN method, 586, 587 
Filter, 80, 81 
Fire a trigger, 504, 505 
FIRST method, 428, 429 
First normal form (1NF), 300-303 
Fixed-length string, 232, 233 
FLASHBACK privilege, 384, 385 
FLOAT data type, 15, 231, 234, 235 
Floating-point number, 230, 231, 234, 235 
searching for, 258 
FLOOR function, 257 
FOR EACH ROW clause, 504, 505 
FOR loop, 422, 423 
FOR UPDATE clause, 576, 577, 580 
FOR...IN...LOOP keywords, 413 
FORCE keyword (CREATE VIEW), 356, 357 
Foreign key, 12, 13 
constraint, 294, 295, 316, 317 
identifying, 292, 293 
referential integrity, 294, 295 
FOREIGN KEY keywords, 316, 317 
Form (normal), 296, 297, 300, 301 
Format date/time, 244, 245 
Format elements for timestamps, 546, 547 
Format mask, 92 
Format number, 242, 243 
forName method (Java), 40 
Fourth normal form (4NF), 300, 301 
FREETEMPORARY method, 587 
FROM clause, 24, 25, 80, 81, 120, 121 
and subquery, 196, 197 
FROM TZ function, 548, 549 
Front end, 7 
Front-end processing, 7 
FULL keyword, 134, 135 
Full outer join, 134-141 
Function, 92, 93, 482, 483 
calculating balance due, 484, 485 
calling 482, 483 
compiling, 494, 495 
creating, 482, 483 
debugging, 496-409 
dropping, 486, 487 
editing, 494, 495 
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with intervals, 558, 559 
with time zones, 536, 537 
with timestamps, 548, 549 


getChunkSize method (Java), 578, 579 
GETCHUNKSIZE method, 587 
getConnection method (Java), 40 
GETLENGTH method, 587 
GMT (Greenwich Mean Time), 532, 533 
GRANT (DDL event), 513, 514 
GRANT ALL PRIVILEGES statement, 371 
Grant privilege, 494, 495 
GRANT statement, 21, 374, 375, 384, 385 
Greater than operator, 100, 101 
Greater than or equal to operator, 100, 101 
Greenwich Mean Time (GMT), 532, 533 
GROUP BY clause, 164-167 
GROUPING function, 272, 273 

with CASE expression, 272, 273 


HAVING clause, 164-167 

and subquery, 180, 181 

compared to WHERE clause, 168, 169 
Hierarchical query, 206, 207 


IBM, 16, 17 
Identical column values, 96, 97 
IDENTIFIED BY clause, 382, 383 
IDENTITY keyword, 314, 315 
IF statement, 418, 419 
IF... ELSIF...ELSE keywords, 413 
Image 
reading from a table, 580, 581 
writing to a table, 576, 577 
Implicit syntax, 120, 121 
inner join, 132, 133 
outer join, 140, 141 
Import database connection, 54, 55 
IN keyword, 466, 467 
IN operator, 104, 105 
IN OUT keywords, 466, 467 
INDEX BY keywords, 428, 429 
Index, 10, 11, 298, 299, 326, 327 
creating, 326, 327 
dropping, 326, 327 
identifying columns, 298, 299 
in SQL Developer, 342, 343 


Index-by table 


Index-by table, 427-429 
Informix, 18 
INITCAP function, 248-251 
Inline view, 196, 197 
Inner join, 26, 27, 120-133 
explicit syntax, 120, 121 
implicit syntax, 132, 133 
more than two tables, 130, 131 
SQL-92 syntax, 120, 121 
INNER keyword, 120, 121 
Input parameter, 36, 466, 467 
Input/output parameter, 466, 467 
INSERT privilege, 374, 375, 379 
INSERT statement, 21, 28, 29, 216, 217 
default value, 218, 219 
multiple rows from subquery, 220, 221 
null value, 218, 219 
through view, 362, 363 
INSERTING trigger predicate, 510, 511 
Instance, 284, 285 
INSTEAD OF trigger, 512, 513 
INSTR function, 248-251 
INSTR method, 587 
INT data type, 231 
INTEGER data type, 230, 231 
Integer, 230, 231 
Integrity (referential), 294, 295 
Internal LOB type, 562, 563, 568, 569 
INTERSECT operator, 154-155 
Interval, 552-559 
with functions, 558, 559 
INTERVAL data types, 552, 553 
INTERVAL DAY TO SECOND data type, 552, 553, 
556, 557 
INTERVAL YEAR TO MONTH data type, 552-555 
INTO clause (SELECT), 416, 417 
INTO keyword (INSERT), 216, 217 
INVALID NUMBER exception, 433 
Invoices base table, 24, 25 
IS NULL clause, 110, 111 
IS VARRAY keywords, 426, 427 
ISOPEN method, 586, 587 
ISTEMPORARY method, 587 


J 


Java, 40, 41 
application, 38, 39 
driver, 39 
with LOBs, 574, 575 
Java Database Connectivity (JDBC), 6, 7, 38, 39 


Literal 


java.sql package, 40 
JDBC (Java Database Connectivity), 6, 7, 38, 39 
driver, 40, 41, 43 
object, 40, 40, 43 
JOIN keyword, 120, 121 
Join, 26, 27, 120-133 
compared to subquery, 182, 183 
compound condition, 126, 127 
condition, 120, 121 
cross, 148, 149 
implicit syntax, 132, 133 
inner, 26, 27, 120-133 
natural, 146, 147 
outer, 26, 27, 134-141 
self, 128, 129 


Key 
column, 13 
composite primary, 10, 11 
foreign, 12, 13 
identifying, 292, 293 
non-primary, 10, 11 
primary, 10, 11 
unique, 10, 11 

Keyword, 80, 81 


L 


LAN, 4, 5 
Large object (LOB) data type, 230, 231, 238, 239, 
562-590 
LAST method, 428, 428 
LEFT keyword, 134, 135 
Left outer join, 134-141 
LENGTH function, 248-251 
with BLOB type, 566, 567 
with CLOB type, 564-567 
Less than operator, 100, 101 
Less than or equal to operator, 100, 101 
LEVEL pseudo column, 206, 207 
Levels of compliance, 17 
LIKE operator, 108, 109 
Linking table, 292, 293 
Linux operating system, 18, 19 
Listener, 48, 49 
Literal 
date, 100, 101 
numeric, 100, 101 
string, 88, 89, 100, 101 
value, 88, 89 
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LOADBLOBFROMFILE method 


LOADBLOBFROMFILE method, 587 
LOADCLOBFROMFILE method, 587 
LOB (large object) data type, 562-590 
migrating, 572, 573 
storage options, 570, 571 
with Java, 574, 575 
with PL/SQL, 586-589 
LOB locator, 564, 565 
Local area network (LAN), 4, 5 
LOCALTIMESTAMP function, 548, 549 
Locking, 452-457 
LOGGING option, 570, 571 
Logical operator, 102, 103 
LONG RAW data type, 238, 239, 562, 563 
converting, 572, 573 
LONG data type, 238, 239, 562, 563 
converting, 572, 573 
Loop, 422, 423 
LOOP...EXIT WHEN keywords, 413 
Lost update, 454, 455 
LOWER function, 248-251 
in ORDER BY clause, 112, 113 
LPAD function, 248-251 
LTRIM function, 248-251 


Mainframe computers, 16 


Many-to-many relationship, 12, 13, 292, 293 


Mask, 108, 109 
MAX function, 160-163 
Method (defined), 586, 587 
Microsoft Loopback Adapter, 606-609 
MIN function, 160-163 
Minicomputer, 16 
MINUS operator, 154-155 
Mixed-case columns (sorting), 254, 255 
MOD function, 90-93, 257 
Model (data access), 38, 39 
Modulo operator, 91 
MONTHS, BETWEEN function, 260, 261 
Multiplication operator, 91 
Multivalued dependency, 300, 301 
Mutating-table error 
defined, 520, 521 
solving, 522, 523 
MySQL database system, 18, 19 


NULL statement 


Name 

column, 86, 87 

Schema, 124, 125 

table, 124, 125 
NATIONAL CHAR data type, 231 
NATIONAL CHAR VARYING data type, 231 
NATIONAL CHARACTER data type, 231 
National Character Large Object (NCLOB), 562-565 
NATIONAL CHARACTER VARYING data type, 231 
Native dynamic SQL (NDS), 438, 439 
Natural join, 146, 147 
NATURAL keyword, 146, 147 
NCHAR data type, 231-233 
NCHAR VARYING data type, 231 
NCHR function, 246, 247 
NCLOB (National Character Large Object) data type, 

238, 239, 562-565 

NDS (Native Dynamic SQL), 438, 439 
Nested 

sort, 112, 113 

statements, 418, 419 

subqueries, 180, 181 

table, 426, 427 

view, 356, 357 
Network, 4, 5 
NEW correlation identifier, 504-506 
New rows (inserting), 216, 217 
NEW. TIME function, 536, 537 
NEXT. DAY function, 260, 261 
NEXTVAL pseudo column, 28, 29, 328, 329 
NO DATA FOUND exception, 433 
NOCACHE option, 570, 571 
NOLOGGING option, 570, 571 
Noncorrelated subquery, 192, 193 
Non-primary key, 10, 11 
Nonrepeatable read, 454, 455 
NONVALIDATE keyword (ALTER TABLE), 322, 323 
Normal form, 296, 297, 300, 301 
Normalization, 296, 297, 300-309 
Not equal operator, 100, 101 
NOT NULL attribute, 312-315 
NOT operator, 102, 103 
Notation (scientific), 234 
NTILE function, 274-277 
NULL keyword 

and INSERT, 218, 219 

and UPDATE, 222, 223 
NULL statement, 434, 435 


Null value 


Null value, 14, 15, 110, 111 
and aggregate function, 160, 161 
and searching, 110, 111 
Number (converting), 240-242 
NUMBER data type, 15, 231, 234, 235 
Number format elements, 242, 243 
Number of rows (limiting), 98, 99 
NumberFormat class (Java), 42 
Numeric data type, 230, 231, 234, 235 
functions for, 256, 257 
working with, 256-259 
Numeric literal, 100, 101 
NUMTODSINTERVAL function, 558, 559 
NUMTOYMINTERVAL function, 558, 559 
NVARCHAR2 data type, 231-233 
NVL function, 248-251, 270, 271 
NVL2 function, 248-251, 270, 271 
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Object database, 44 
Object privileges, 378, 379 
Object-oriented programming language, 44 
OCI driver, 38, 39 
Offset (time zone), 532, 533 
OLD correlation identifier, 504-506 
OLE DB, 38, 39 
ON DELETE clause (CREATE TABLE), 316, 317 
ON keyword (GRANT), 378 
One-to-many relationship, 12, 13, 292, 293 
One-to-one relationship, 12, 13, 292-294 
OPEN method, 586, 587 
Open source database system, 18, 19 
Open SQL statements, 68, 69 
Open SQL Worksheet button, 62, 63 
Operating system 
Linux, 18, 19 
Unix, 18, 19 
Windows, 18, 19 
z/OS, 18, 19 
Optional parameter, 468, 469 
OR operator, 102, 103 
OR REPLACE keywords 
in CREATE PROCEDURE, 462, 463 
in CREATE TRIGGER, 504, 505 
in CREATE VIEW, 354-357 
Oracle Database, 16, 17 
compared to SQL Server and DB2, 18, 19 
connecting to, 610, 611 


Phantom read 


data types, 14, 15 
Enterprise Edition (installing), 604, 605 
Express Edition (installing), 592, 593 
installing, 604, 605 
Standard Edition (installing), 604, 605 
Oracle documentation (installing), 596, 597 
Oracle SQL Developer, see also SQL Developer 
described, 54 
installing, 594, 595 
Oracle Technology Network (OTN), 604, 605 
ORDER BY clause, 24, 25, 80, 81, 112-115 
alias, 114, 115 
coding, 164, 165 
column position, 114, 115 
DISTINCT keyword, 112, 113 
expressions in, 114, 115 
of a ranking function, 274-277 
Order of precedence, 90, 91, 102, 103 
Orphaned rows, 294, 295 
OTHERS keyword, 430, 431 
OTN (Oracle Technology Network), 604, 605 
OUT keyword (for parameters) 466, 467 
Outer and inner joins (combining), 142, 143 
Outer join, 26, 27, 134-141 
examples, 136, 137 
more than two tables, 138, 139 
Output parameter, 36, 466, 467 
Owner, 124, 125 


Package, 488, 480 
advantages of, 490 
creating, 488, 489 
dropping, 490, 491 
Packages (for SQL standard), 16, 17 
Parameter, 34, 92, 03, 462, 463 
input, 466, 467 
input/output, 466, 467 
output, 466, 467 
passing by name, 464, 465 
passing by position, 464, 465 
stored procedure, 34 
Parentheses, 102, 103 
Parsing date/time values 262-263 
PARTITION BY clause, 274, 275 
Pattern (string), 108, 109 
PAUSE command, 442, 443 
PCTVERSION option, 571, 572 
Phantom read, 454, 455 
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PL/SQL (Procedural Language/SQL) 


PL/SQL (Procedural Language/SQL), 34, 35, 410-443 
block, 410, 411 
documentation, 596, 597 
statements, 412-415 
with large objects, 586-589 
PLS_INTEGER keyword, 428, 429 
PostgreSQL database system, 18 
POWER function, 257 
Precedence, 90, 91 
Precision of a NUMBER type, 234, 235 
Predefined exception, 432, 433 
Predicate, 80-82 
Primary key, 10, 11, 13, 314, 315 
and referential integrity, 294, 295 
composite, 10, 11 
identifying, 292, 293 
Printing data to an output window, 414, 415 
PRIOR keyword, 206, 207 
Private synonym, 388, 389 
Privilege 
granting, 384, 385, 494, 495 
revoking, 386, 387, 494, 495 
viewing, 396, 397 
Procedural Language/SQL (PL/SQL), 34, 35, 410-443 
Procedure, 462, 463, see also Stored procedure 
compiling, 494, 495 
debugging, 496-499 
editing, 494, 495 
PROMPT command, 440, 441 
Propriety database systems, 18 
Pseudo column, 28, 29, 98, 99 
Pseudocode, 202, 203 
Pseudocolumn, see Pseudo column 
Public synonym, 390, 391 
PUT procedure, 412, 413 
PUT_LINE procedure, 412, 413 
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Qualified column name, 120, 121 
Query, 24, 25 
aggregate, 160-163 
results, 7 
SQL, 6, 7 
summary, 160-163 
QUOTA clause (CREATE USER), 380, 381 
Quotes for string literal, 88, 89 


Rollback 


Raise an error, 470, 471 
RAISE statement, 471-473 
RAISE_APPLICATION_ERROR procedure, 472, 473 
RANK function, 274-277 
Ranking functions, 274-277 
RAW data type, 238, 239, 562, 563 
READ COMMITTED keyword, 456, 457, 459 
READ method, 587 
READ UNCOMMITTED keyword, 456, 457 
Read-only view, 358, 359 
REAL data type, 231 
Record, 10, 11 
Redundant data, 296, 297 
Reference constraint, 316, 317 
Reference manual, see Oracle documentation 
REFERENCES keyword, 316, 317 
Referential integrity, 294, 295 
Related tables, 12, 13 
Relational database, 10, 11 
Relationship 
ad hoc, 120, 121 
between tables, 12, 13, 292, 293 
Rename columns (SELECT), 86, 87 
RENAME statement (tables), 324, 325 
RENAME TO keywords (trigger), 516, 517 
REPEATABLE READ keyword, 456, 457 
REPLACE function, 248-251 
RESOURCE role, 400 
Restore sample tables, 600, 601 
Result set, 24, 25 
sorted by column name, 112, 113 
Result table, 24, 25 
Results (query), 7 
Results tab, 62, 63 
ResultSet object (Java), 40, 42 
RETURN keyword, 482, 483 
Revoke privilege, 494 495 
REVOKE statement, 21, 374, 375, 386, 387 
DDL event, 513, 514 
RIGHT keyword, 134, 135 
Right outer join, 134-141 
Role 
creating, 382, 383 
defined, 374, 375 
dropping, 382, 383 
with SQL Developer, 400, 401 
Rollback, 448, 449 


ROLLBACK statement 


ROLLBACK statement, 214, 215, 448-451 
ROLLUP operator, 172, 173 
in GROUP BY clause, 272, 273 
ROUND function, 92, 93, 256, 257 
with date format, 260, 261 
Row, 10, 11 
ROW. NUMBER function, 274, 275 
Rowid data type, 230, 231 
ROWID pseudo column, 230, 231 
Row-level trigger, 504, 505 
ROWNUM pseudo column, 98, 99 
Rows 
duplicate, 96, 97 
limiting, 98, 99 
RPAD function, 248-251 
RR format element, 244, 245 
RTRIM function, 248-251 
Run Script button, 70, 71 


Save point, 450, 451 
Save SQL statements, 68, 60 
SAVEPOINT statement, 450, 451 
Scalar aggregate, 164, 165 
Scalar function, 92, 03, 482, 483 
Scalar variable, 416, 417 
Scalar-valued function, 482, 483 
Scale (NUMBER type), 234, 235 
Scan (table), 208 
Schema, 124, 125, 370, 371 
creating for this book, 212, 213 
SCHEMA keyword (with trigger), 513, 514 
Scientific notation, 234 
Script, 332, 333, 410-413 
creating roles, 392-395 
creating users, 392-395 
running from a command line, 440, 441 
Script Output tab, 70, 71 
Search 
by date value, 264, 265 
by time value, 266, 267 
for null, 110, 111 
Search condition, 80-82 
compound, 102, 103, 170, 171 
subquery, 180, 181 
Searched CASE statement, 420, 421 
Second normal form (2NF), 300, 301, 304, 305 
Security 
managing, 370-403 
with SQL Developer, 398-403 


Single quotes 


SELECT clause 24, 25, 80, 81, 84-99 
with subquery, 198, 199 
SELECT privilege, 374, 375, 379 
SELECT statement, 21, 24, 25, 80-83 
CASE expression 268, 260 
COALESCE function, 271 
examples, 82 
floating-point numbers, 250 
GROUP BY clause, 165 
HAVING clause, 165 
NVL function, 271 
NVL2 function, 271 
subquery, 180, 181 
SUBSTR function, 253 
TRUNC function, 264, 265 
Self-join, 128, 129 
SEQUEL, (Structured English Query Language), 16, 17 
Sequence, 22, 23, 328, 329 
altering, 330, 331 
dropping, 330, 331 
with SQL Developer, 344, 345 
SERIALIZABLE keyword, 456, 457, 459 
Server, 4, 5 
application, 8, 9 
database, 48, 40 
software, 6, 7 
web, 8,9 
Service 
database, 48, 40 
web, 8, 9 
Session settings, 534, 535 
Session time zone, 532, 533 
SESSIONTIMEZONE function, 532, 533, 536, 537 
Set (result), 24, 25 
SET clause (UPDATE), 222, 223 
SET NULL keyword (ON DELETE clause), 316, 317 
Set operators, 154, 155 
SET ROLE statement, 400, 401 
SET SERVEROUTPUT ON command, 412-415, 518, 
519 
SET TRANSACTION ISOLATION LEVEL statement, 
456, 457 
Set up sample tables, 600, 601 
SIGN function, 257 
Simple CASE statement, 420, 421 
Simple loop, 422, 423 
Single quotes 
for string literal, 88, 89 
in alias, 86, 87 
to create literal value, 88, 89 
within string literal, 88, 89 
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Single-line comment 


Single-line comment, 32, 33 
Single-precision, floating-point number, 234, 235 
Sixth normal form (6NF), 300, 301 
SMALL INT data type, 231 
SNAPSHOT keyword, 456, 457 
Snippets, 64, 65 
Software, 6, 7 
SOME keyword, 190, 191 
Sort, see also ORDER BY clause 
Sort order, 112, 113 
Source code (installing), 598, 599 
Source files (installing), 598, 599 
Specification 
column, 84, 85 
package, 488, 489 
SPOOL command, 440, 441 
SPOOL OFF command, 440, 441 
Sproc, 462, 463 
SQL, 6, 7 
ANSI-standards, 16, 17 
coding guidelines, 32, 33 
dialect, 16, 17 
extensions to, 16, 17 
history 16, 17 
query, 6, 7 
standards, 16, 17 
variant, 16, 17 
SQL data types, 230, 231 
SQL Developer, 54 
installing, 594, 595 
running SQL statements, 62, 63 
viewing database objects, 372, 373 
working with database objects, 338-335 
working with functions, 492-499 
working with packages, 492, 493 
working with procedures, 492-499 
working with roles, 400, 401 
working with security, 398-403 
working with system privileges, 402, 403 
working with triggers, 524-527 
working with users, 398, 399 
working with views, 366, 367 
SQL documentation 
installing, 596, 597 
using, 72, 73 
SQL script, 70, 71 
SQL Server (Microsoft), 16, 17 
compared to Oracle and DB2, 18, 19 
SQL standards, 16, 17 
SQL statement, 20, 21 
entering and executing, 62, 63 


Statements 


opening, 68, 69 
saving, 68, 69 
SOL Worksheet window, 62, 63 
SQL*Plus, 52, 53, 376, 377 
SQL/Data System, (SQL/DS), 16, 17 
SQL/DS (SQL/Data System), 16, 17 
SQL-92 standards, 120, 121 
SQLERRM function, 430, 431 
SQLPLUS command, 52, 53, 442, 443 
SQRT function, 257 
Standard Edition (Oracle Database) 
connecting to, 610, 611 
installing, 604, 605 
Standard SQL, 17 
Start Database command, 48, 49 
START WITH clause, 206, 207, 328, 329 
Statement-level trigger, 504, 505 
Statements 
ALTER DATABASE, 534, 535 
ALTER INDEX, 21 
ALTER SEQUENCE, 21, 330, 331 
ALTER SESSION, 534, 535 
ALTER TABLE, 21, 320-323 
ALTER TRIGGER, 516, 517 
ALTER USER, 21, 380, 381 
ALTER VIEW, 364, 365 
CALL, 464, 465 
CASE, 420, 421 
COMMIT, 34, 35, 214, 215, 448, 449 
CREATE DIRECTORY, 568, 569 
CREATE FUNCTION, 36, 37 
CREATE INDEX, 21, 326, 327 
CREATE PACKAGE BODY, 488, 489 
CREATE PACKAGE, 488, 489 
CREATE PROCEDURE, 34, 35, 462, 463 
CREATE PUBLIC SYNONYM, 390, 391 
CREATE ROLE, 374, 375, 382, 383 
CREATE SEQUENCE, 21, 328, 329 
CREATE SYNONYM, 388, 389 
CREATE TABLE AS, 213 
CREATE TABLE, 21, 212, 213, 312-319 
CREATE TRIGGER, 504, 505 
CREATE USER, 21, 370, 371, 374, 375, 380, 381 
CREATE VIEW, 30, 31, 350, 351, 354, 355, 364, 
365 
DELETE, 21, 28, 29, 226, 227 
DROP DIRECTORY, 568, 569 
DROP FUNCTION, 486, 487 
DROP INDEX, 21, 326, 327 
DROP PACKAGE BODY, 490, 491 
DROP PACKAGE, 490, 491 
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DROP PROCEDURE, 480, 481 
DROP PUBLIC SYNONYM, 390, 391 
DROP ROLE, 382, 383 
DROP SEQUENCE, 21, 330, 331 
DROP SYNONYM, 388, 389 
DROP TABLE, 21, 212, 213, 324, 325 
DROP TRIGGER, 516, 517 
DROP USER, 21, 370, 371, 380, 381 
DROP VIEW, 364, 365 
EXECUTE IMMEDIATE, 434, 435 
GRANT ALL PRIVILEGES, 371 
GRANT, 21, 374, 375, 384, 385 
INSERT, 21, 28, 29, 216, 217 
NULL, 434, 435 
RAISE, 471-473 
RENAME (for tables), 324, 325 
REVOKE, 21, 374, 375, 386, 387 
ROLLBACK, 214, 215, 448-451 
SAVEPOINT, 450, 451 
SELECT, 21, 24, 25, 80-83 
SET ROLE, 400, 401 
SET TRANSACTION LEVEL, 456, 457 
TRUNCATE TABLE, 324, 325 
UPDATE, 21, 28, 29, 34, 35, 222, 223 
Stop Database command, 48, 49 
STORE AS clause, 570, 571 
Stored function, 482, 483 
Stored procedure, 36, 462-449 
defined, 34, 35 
dropping, 480, 481 
that drops a table, 478, 479 
that inserts a row, 474, 475 
String 
data type, 230, 231 
parsing, 252, 253 
sorting in alphabetical sequence, 254, 255 
sorting in numerical sequence, 254, 255 
String constant, 88, 89 
String data, 88, 89 
concatenating, 88, 89 
formatting, 88, 89 
String expression, 88, 89 
String literal, 88, 89, 100, 101 
String pattern, 108, 109 
Structure (data), 284, 285 
Structured English Query Language, (SEQUEL), 16, 17 
Structured Query Language, see SOL 
Subprogram, 37, 488 
Subquery, 98, 99, 104, 105, 180-199 
and ALL keyword, 188, 189 
and ANY keyword, 190, 191 
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and comparison operator, 186, 187 
and EXISTS keyword, 194, 195 
and IN operator, 184, 185 
and NOT IN operator, 184, 185 
and SOME keyword, 190, 191 
compared to join, 182, 183 
correlated, 192, 193 
in a DELETE statement, 226, 227 
in FROM clause, 196, 197 
in INSERT statement, 220, 221 
in search conditions, 184, 185 
in SELECT clause, 198, 199 
in UPDATE statement, 224, 225 
noncorrelated, 192, 193 
to insert multiple rows, 220, 221 
Subquery factoring, 204, 205 
Subquery predicate, 180, 181 
Subquery search condition, 180, 181 
Substitution variable, 436-439 
SUBSTR function, 92, 93, 248-251, 253 
SUBSTR method, 587 
Subtraction operator, 91 
SUM function, 160-163 
Summary query, 160-163 
Sybase database system, 18 
Synonym, 374, 375 
private, 388, 389 
public, 390, 391 
Syntax 
explicit inner join, 120, 121 
implicit inner join, 132, 133 
SQL-92, 120, 121 
Syntax errors (handling), 66, 67 
Syntax conventions, 80, 81 
SYS_EXTRACT_UTC function, 548, 549 
SYSDATE function, 92, 93, 260, 261, 536, 537 
System privileges, 378, 379 
with SQL Developer, 402, 403 
System/R, 16, 17 
SYSTIMESTAMP function, 548, 549 
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Table, 10, 11 
alias, 122, 123 
associate, 292, 293 
base, 24, 25 
column definitions, 338, 339 
connecting, 292, 293 
linking, 292, 293 
name, 124, 125 
relationships between, 12, 13 
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Table data (viewing) 


Table data (viewing), 58, 59 
TABLE keyword, 426, 427 
Table scan, 298 
Table-level constraint, 314, 315 
Tablespace, 370, 371, 380, 381 
Temporal data type, 230, 231, 236, 237, 
see also Date/time data type 
Teradata, 18 
Test tables (creating), 212, 213 
Text data type, 230, 231 
THEN clause, 268, 269 
Theta syntax, 133 
Thin client, 8 
Thin driver, 38, 39 
Third normal form (3NF), 300, 301, 306, 307 
THZ element, 546, 547 
Time 
searching for, 266, 267 
parsing, 262, 263 
Time zone, 532, 533 
and functions, 536, 537 
Timestamp, 538-551 
formatting, 546, 547 
with functions, 548, 549 
TIMESTAMP type, 538-541 
TIMESTAMP WITH LOCAL TIME ZONE type, 538, 
539, 542, 543 
TIMESTAMP WITH TIME ZONE type, 538, 539, 544, 
545 
TO BLOB function, 566, 567 
TO CHAR function, 92, 93, 240, 241 
with date/time values, 262, 263 
TO CLOB function, 564, 565 
TO DATE function, 240, 241 
TO DSINTERVAL function, 558, 559 
TO NCHAR function, 240 
TO NCLOB function, 564, 565 
TO NUMBER function, 240, 241 
with date/time components, 262, 263 
TO TIMESTAMP function, 240, 548, 549 
TO TIMESTAMP TZ function, 548, 549 
TO YMINTERVAL function, 558, 559 
Transaction, 214, 215, 448-460 
when to use, 449 
Transaction isolation level, 456-459 
Transitive dependency, 300, 301 
Trigger, 504-528 
compound, 518, 519 
database events, 513, 514 
DDL statements, 513, 514 
debug with SQL Developer, 526, 527 


Update (lost) 


defined, 36 
disable, 516, 517 
disable with SQL Developer, 524, 525 
drop, 516, 517 
drop with SQL Developer, 524, 525 
edit with SQL Developer 524-527 
enable, 516, 517 
enable with SQL Developer, 524, 525 
enforcing data consistency, 506, 507 
rename, 516, 517 
rename with SQL Developer, 524, 525 
row-level, 504, 505 
sequences, 508, 509 
statement-level, 504, 505 
view with SQL Developer, 524, 525 
Trigger predicates, 510, 511 
TRIM function, 248-251 
TRIM method, 587 
TRUNC function, 256, 257 
in SELECT statement, 264, 265 
with date format, 260, 261 
TRUNCATE TABLE statement, 324, 325 
Type (data), see Data type 
TYPE keyword, 426, 427 
TZ, OFFSET function, 536, 537 
TZD element, 546, 547 
TZM element, 546, 547 
TZR element, 546, 547 


UDF (User-defined function), 36, 37, 482-487, see also 


Function 
Unicode character set, 232, 233 
Union, 150-153 
UNION keyword, 150-153 
UNIQUE attribute, 312-315 
Unique key, 10, 11 
Unix operating system, 18, 19 
Unix shell script, 440-443 
UNLIMITED keyword (QUOTA clause), 380, 381 
UNLIMITED TABLESPACE privilege, 379 
Unnormalized data structure, 296, 297 
Updatable view, 358, 359 
with trigger, 512, 513 
Update existing rows, 222, 223 
UPDATE privilege, 379 
UPDATE statement, 21, 28, 29, 34, 35, 222, 223 
through view, 360, 361 
with subquery, 224, 225 
Update (lost), 454, 455 


UPDATING trigger predicate 


UPDATING trigger predicate, 510, 511 
UPPER function, 248-251 
User, 124, 125 

altering, 380, 381 

creating, 380, 381 

dropping, 380, 381 

working with in SQL Developer, 398, 399 
User-defined exception, 432, 433 
User-defined function (UDF), 36, 37, 482-487, see also 

Function 

USING keyword, 144, 145 
UTC (Coordinated Universal Time), 532, 533 
Utility class for databases (Java), 582, 583 
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Value, 10, 11 

literal, 88, 89 

null, 110, 111 
VALUE ERROR exception, 433, 470, 471 
VALUES clause, 216, 217 
VARCHAR? data type, 15, 231-233 
Variable, 416, 417 

bind, 436, 437 

declaring, 416, 417 

substitution, 436-439 

using, 416, 417 
VARIABLE keyword, 436, 437 
Variable-length strings, 232, 233 
Varray, 426-429 
Vector aggregate, 164, 165 
View, 350-368 

benefits, 352, 353 

creating, 354, 355 

defined, 30, 31 

deleting through, 362, 363 

inserting through, 362, 363 

nested, 356, 357 

updating through, 360, 361 

with SQL Developer, 366, 367 
Viewed table, 351 
Violate referential integrity, 204, 295 
Virtual table, 30, 31 
Visual Basic, 38, 39 
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WAN, 4,5 

Web application, 8, 9 
Web browser, 8, 9 
Web server, 8, 9 


ZERO_DIVIDE exception 


Web service, 8, 9 
Web-based system, 8, 9 
WHEN clause (in CASE expression), 268, 269 
WHERE clause, 24, 25, 80-82, 100-111 
and DELETE, 226, 227 
and subquery, 180-187 
and UPDATE, 222, 223 
compared to HAVING clause, 168, 169 
WHILE loop, 422, 423 
WHILE...LOOP keywords, 413 
Wide-area network (WAN), 4, 5 
Wildcard (LIKE phrase), 108, 109 
Windows operating system, 18, 19 
WITH ADMIN OPTION clause (GRANT), 384, 385 
WITH CHECK OPTION clause (CREATE VIEW), 356, 
357, 360, 361 
WITH GRANT OPTION clause (GRANT), 384, 385 
WITH READ ONLY clause (CREATE VIEW), 358, 359 
WRITE method, 586, 587 
WRITEAPPEND method, 587 


XYZ 


XE (Oracle Database Express Edition), 592, 593 
z/OS operating system, 18, 19 
ZERO. DIVIDE exception, 433 
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